Skip to content

feat(agent-help): self-describing usage command for coding agents - #138

Open
steve-calvert-glean wants to merge 1 commit into
sc/platform-08-agenthelp-pkgfrom
sc/platform-09-agent-help-cmd
Open

feat(agent-help): self-describing usage command for coding agents#138
steve-calvert-glean wants to merge 1 commit into
sc/platform-08-agenthelp-pkgfrom
sc/platform-09-agent-help-cmd

Conversation

@steve-calvert-glean

Copy link
Copy Markdown
Collaborator

glean agent-help [command...] [--json] emits usage generated from the installed binary (inspired by Entire's agent-help): environment context (version, server, auth state, API mode) plus a when-to-use command map, or full per-command detail. Works unauthenticated. glean schema becomes a hidden alias.

A bidirectional drift test now forces every visible command to have a registry entry and every entry to name a live command. It immediately caught a real bug: the registry (and the skills generated from it) documented a 'glean version' command that does not exist — removed here.

Part 8/9.

🤖 Generated with Claude Code

@steve-calvert-glean
steve-calvert-glean marked this pull request as ready for review July 20, 2026 00:17
@steve-calvert-glean
steve-calvert-glean requested a review from a team as a code owner July 20, 2026 00:17
@steve-calvert-glean
steve-calvert-glean force-pushed the sc/platform-08-agenthelp-pkg branch from ce787c6 to c2f421e Compare July 27, 2026 17:05
@steve-calvert-glean
steve-calvert-glean force-pushed the sc/platform-09-agent-help-cmd branch from 1610de7 to 7c7fd19 Compare July 27, 2026 17:05
@steve-calvert-glean
steve-calvert-glean force-pushed the sc/platform-08-agenthelp-pkg branch from c2f421e to 256c2f7 Compare July 27, 2026 17:12
@steve-calvert-glean
steve-calvert-glean force-pushed the sc/platform-09-agent-help-cmd branch from 7c7fd19 to a1e0e24 Compare July 27, 2026 17:12
@steve-calvert-glean
steve-calvert-glean force-pushed the sc/platform-08-agenthelp-pkg branch from 256c2f7 to eed9ca6 Compare July 27, 2026 17:15
@steve-calvert-glean
steve-calvert-glean force-pushed the sc/platform-09-agent-help-cmd branch from a1e0e24 to 2bef0d5 Compare July 27, 2026 17:16
@steve-calvert-glean
steve-calvert-glean force-pushed the sc/platform-08-agenthelp-pkg branch from eed9ca6 to 60affa8 Compare July 27, 2026 17:19
@steve-calvert-glean
steve-calvert-glean force-pushed the sc/platform-09-agent-help-cmd branch from 2bef0d5 to ed26b8f Compare July 27, 2026 17:19
glean agent-help [command...] [--json] emits usage generated from the
installed binary (Entire-style): environment context (version, server,
auth state, API mode) plus a when-to-use command map, or full per-command
detail. Works unauthenticated. glean schema becomes a hidden alias.

A bidirectional drift test now forces every visible command to have a
registry entry and every entry to name a live command — it immediately
caught and removed a stale 'version' entry documenting a command that
does not exist.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@steve-calvert-glean
steve-calvert-glean force-pushed the sc/platform-09-agent-help-cmd branch from ed26b8f to 1e6c233 Compare July 27, 2026 17:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant