docs: surface orphan pages and add compaction, commands, and user-settings docs#3683
Merged
Conversation
Sayt-0
approved these changes
Jul 16, 2026
gtardif
approved these changes
Jul 16, 2026
…hatGPT, and NVIDIA pages
…ng, and per-frontend behavior
Corrects three factual errors from local review:
- $1/$2 and !`command` never existed; the resolver (pkg/runtime/commands.go)
supports ${args[0]}, ${args.join(" ")}, ${tool_name({...})}, and the legacy
!tool_name(...) bang syntax.
- agent: can target any agent in the team (team.Team.Agent), not just one
listed in the current agent's sub_agents (agent_router.go, team.go,
agent-schema.json already documented this correctly).
- url precedence over agent only holds in the full TUI (handlers.go); the
lean TUI (leantui/update.go) only dispatches resolved text and never
opens a browser or switches agents, and the CLI (cli/runner.go) switches
agents but never checks url.
warn_on_cache_miss exists on main (pkg/userconfig/userconfig.go, defaults false) and is exposed in the Notifications settings tab (pkg/tui/dialog/settings.go) but was missing from the reference table and complete example. The blanket 'CLI flags override user settings' claim doesn't hold for --yolo/--hide-tool-results: applyUserSettings (cmd/root/run.go) reapplies a saved true setting on top of an explicit --yolo=false / --hide-tool-results=false because those flags don't track whether they were explicitly passed. --lean and --theme do track this and override correctly.
URL-only commands on the CLI and lean TUI still dispatch the resolved (usually empty) text as a user message and can trigger a model turn — they just don't open the browser. Align with the correct wording already used at lines 29 and 218.
aheritier
force-pushed
the
docs/p0-coverage
branch
from
July 16, 2026 14:02
d5e6f48 to
cc189ad
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Closes several end-user documentation coverage gaps in the docs site:
docs/data/nav.yml— Kanban Board, Background Jobs, Scheduler, ChatGPT, NVIDIA.docs/guides/compaction/index.md— task-oriented Context & Compaction guide (automatic compaction,/compact//context, tool-result trimming, context gauge, cost across compaction).docs/configuration/commands/index.md— custom slash commands (prompt, URL, and agent-switching commands; reusable command groups;--disable-commands).docs/configuration/user-settings/index.md— full user-settings reference and precedence rules.Notes
Docs-only. All flags/fields/commands verified against source (
agent-schema.json,pkg/userconfig,pkg/compaction,cmd/root/*.go); locally reviewed for factual accuracy. Passes canonical check + markdownlint.Note
This PR (#3683) and #3684 both touch
docs/configuration/agents/index.md. Whichever merges second will need a trivial rebase.