Goal
Bring the help / discover experience from scripted_tool into regular Bashkit command execution.
Current state
scripted_tool already has runtime help and discover builtins- regular Bash execution does not expose comparable shell-wide introspection for builtins, functions, aliases, or custom builtins
Proposal
Add shell-wide help and discover backed by a shared command metadata registry.
Scope
- list builtins, functions, aliases, and custom builtins
help <name> for human-readable usagehelp <name> --json for machine-readable metadatadiscover --search, --tag, --category where metadata exists- reuse the same metadata source for docs and future completion
Why
This improves human ergonomics and LLM/tool ergonomics. It also avoids having one discovery model for scripted_tool and another for normal Bash.
Prior art
Goal
Bring the
help/discoverexperience fromscripted_toolinto regular Bashkit command execution.Current state
scripted_toolalready has runtimehelpanddiscoverbuiltinsProposal
Add shell-wide
helpanddiscoverbacked by a shared command metadata registry.Scope
help <name>for human-readable usagehelp <name> --jsonfor machine-readable metadatadiscover --search,--tag,--categorywhere metadata existsWhy
This improves human ergonomics and LLM/tool ergonomics. It also avoids having one discovery model for
scripted_tooland another for normal Bash.Prior art
scripted_toolhelp/discoverimplementationdiscovercommand with tags, search, and categories #521 coversdiscoverinsidescripted_tool, not shell-wide Bash help/discovery