Implement manpage generation for goose-cli#6980
Conversation
|
This will help a lot for packaging in Fedora, but I'm pretty sure that it will also help every other package distribution! |
9094fce to
0676edb
Compare
|
What do the actual manpages look like? Should they be in git? |
Ah, good question! No, definitely not. Manpages are something we want to generate on each release to give people some insights on the CLI args/commands and some usage, when convenient. For instance, take a look at this example (online manpage: https://linux.die.net/man/1/3ddesk). If you spawn any linux container (e.g; This will be helpful for downstream packagers to provide some easy documentation for goose, and it's sub-commands. I know that the user could just run |
This patch brings the capabilities of generating manpages using CLI descriptions. This process is not automated as it would probably not be included in every release or target, so a `just` target was created to easy the work whenever it is needed. Signed-off-by: Rodolfo Olivieri <rodolfo.olivieri3@gmail.com>
0676edb to
5dae5dd
Compare
…tensions-deeplinks * 'main' of github.com:block/goose: [docs] update authors.yaml file (#7114) Implement manpage generation for goose-cli (#6980) docs: tool output optimization (#7109) Fix duplicated output in Code Mode by filtering content by audience (#7117) Enable tom (Top Of Mind) platform extension by default (#7111) chore: added notification for canary build failure (#7106) fix: fix windows bundle random failure and optimise canary build (#7105) feat(acp): add model selection support for session/new and session/set_model (#7112) fix: isolate claude-code sessions via stream-json session_id (#7108) ci: enable agentic provider live tests (claude-code, codex, gemini-cli) (#7088) docs: codex subscription support (#7104) chore: add a new scenario (#7107) fix: Goose Desktop missing Calendar and Reminders entitlements (#7100) Fix 'Edit In Place' and 'Fork Session' features (#6970) Fix: Only send command content to command injection classifier (excluding part of tool call dict) (#7082) Docs: require auth optional for custom providers (#7098) fix: improve text-muted contrast for better readability (#7095) Always sync bundled extensions (#7057)
* origin/main: feat: add AGENT=goose environment variable for cross-tool compatibility (#7017) fix: strip empty extensions array when deeplink also (#7096) [docs] update authors.yaml file (#7114) Implement manpage generation for goose-cli (#6980) docs: tool output optimization (#7109) Fix duplicated output in Code Mode by filtering content by audience (#7117) Enable tom (Top Of Mind) platform extension by default (#7111) chore: added notification for canary build failure (#7106) fix: fix windows bundle random failure and optimise canary build (#7105) feat(acp): add model selection support for session/new and session/set_model (#7112) fix: isolate claude-code sessions via stream-json session_id (#7108) ci: enable agentic provider live tests (claude-code, codex, gemini-cli) (#7088) docs: codex subscription support (#7104) chore: add a new scenario (#7107) fix: Goose Desktop missing Calendar and Reminders entitlements (#7100) Fix 'Edit In Place' and 'Fork Session' features (#6970) Fix: Only send command content to command injection classifier (excluding part of tool call dict) (#7082) # Conflicts: # crates/goose/src/agents/extension.rs
* origin/main: (30 commits) docs: GCP Vertex AI org policy filtering & update OnboardingProviderSetup component (#7125) feat: replace subagent and skills with unified summon extension (#6964) feat: add AGENT=goose environment variable for cross-tool compatibility (#7017) fix: strip empty extensions array when deeplink also (#7096) [docs] update authors.yaml file (#7114) Implement manpage generation for goose-cli (#6980) docs: tool output optimization (#7109) Fix duplicated output in Code Mode by filtering content by audience (#7117) Enable tom (Top Of Mind) platform extension by default (#7111) chore: added notification for canary build failure (#7106) fix: fix windows bundle random failure and optimise canary build (#7105) feat(acp): add model selection support for session/new and session/set_model (#7112) fix: isolate claude-code sessions via stream-json session_id (#7108) ci: enable agentic provider live tests (claude-code, codex, gemini-cli) (#7088) docs: codex subscription support (#7104) chore: add a new scenario (#7107) fix: Goose Desktop missing Calendar and Reminders entitlements (#7100) Fix 'Edit In Place' and 'Fork Session' features (#6970) Fix: Only send command content to command injection classifier (excluding part of tool call dict) (#7082) Docs: require auth optional for custom providers (#7098) ...
Signed-off-by: Rodolfo Olivieri <rodolfo.olivieri3@gmail.com>
Signed-off-by: Rodolfo Olivieri <rodolfo.olivieri3@gmail.com>
Signed-off-by: Rodolfo Olivieri <rodolfo.olivieri3@gmail.com>
Summary
This patch brings the capabilities of generating manpages using CLI descriptions.
This process is not automated as it would probably not be included in every release or target, so a
justtarget was created to easy the work whenever it is needed.Type of Change
AI Assistance
Testing
Related Issues
Relates to #5716
Discussion: LINK (if any)
Screenshots/Demos (for UX changes)
Before:
After: