Skip to content

docs: update docs for --lean TUI, --session new-id, and hook agent_name#3136

Merged
dgageot merged 4 commits into
mainfrom
docs/auto-update
Jun 16, 2026
Merged

docs: update docs for --lean TUI, --session new-id, and hook agent_name#3136
dgageot merged 4 commits into
mainfrom
docs/auto-update

Conversation

@aheritier

@aheritier aheritier commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

Documentation updates

This PR brings the /docs directory in sync with three PRs merged to main in the last 36 hours.

Changes

Source PR Doc change
#3119 Support --session new-id Updated --session flag description to document that an explicit unknown ID creates a new session instead of failing
#3127 Secondary, non-alternate screen ui Expanded --lean flag description; added callout tip explaining the non-alternate-screen rendering
#3110 feat(hooks): populate agent_name on tool-use hook events Added agent_name to pre_tool_use, post_tool_use, and permission_request in the hook event fields table; added explanatory note for multi-agent setups

PRs reviewed and found up to date

Source PR Reason
#3135 fix(acp): respect workspace roots for Zed paths Internal ACP path-resolution fix; no user-facing doc impact
#3133 Disable old tool-call truncation by default Docs already updated in the PR
#3131 feat: warn on unpinned external agent refs and document digest pinning Docs already updated in the PR
#3130 fix(skills): discover .agents/skills in non-git grouping parents Internal discovery behavior fix; no doc-visible contract change
#3129 fix(runtime): finalize event channel on runStreamLoop early returns Internal runtime fix; no user-facing behavior change
#3128 perf(tui): skip sidebar scrollbar-probe pass on animation frames Internal TUI perf optimization; no doc needed
#3126 fix(tui): cache sidebar todo render Internal TUI perf optimization; no doc needed
#3125 fix: run /shell in the active session's working directory Bug fix; behavior now matches existing doc expectation
#3124 Improve the TUI control API Docs already updated in the PR
#3120 Better worktree handling Docs already updated in the PR
#3113 fix: remove todo strikethrough Cosmetic UI-only change; no doc impact
#3111 docs: fix per-model Shift+Tab thinking-level cycle description Docs-only PR; already correct

aheritier added 3 commits June 16, 2026 04:03
@aheritier
docs(cli): document --session new-id behaviour
d48c94d 
An explicit --session ID that doesn't exist creates a new session with
that ID (refs #3119). Update the --session flag description to reflect
this.
@aheritier
docs(cli): expand --lean flag description
768692d 
Clarify that --lean uses a non-alternate-screen render and when it's
useful. Add a callout tip in the cli reference (refs #3127).
@aheritier
docs(hooks): add agent_name to pre/post_tool_use event fields
bf270f9 
pre_tool_use and post_tool_use now populate agent_name in the hook
Input, matching every other event type. Update the event extra-fields
table and add a note explaining what agent_name refers to in
multi-agent setups (refs #3110).
@aheritier aheritier requested a review from a team as a code owner June 16, 2026 04:04
@aheritier aheritier added the kind/docs Documentation-only changes label Jun 16, 2026
docker-agent

This comment was marked as outdated.

Sign in to view

@aheritier
docs(hooks): extend agent_name note to cover permission_request
d659017 
The note added in the PR omitted permission_request even though the
table above it already lists agent_name for that event. Extend the
note to cover all three (refs #3110).
@aheritier aheritier added area/agent For work that has to do with the general agent loop/agentic features of the app area/cli CLI commands, flags, output formatting labels Jun 16, 2026
@dgageot dgageot merged commit 541a20f into main Jun 16, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@docker-agent docker-agent docker-agent left review comments

@dgageot dgageot dgageot approved these changes

Assignees

No one assigned

Labels

area/agent For work that has to do with the general agent loop/agentic features of the app area/cli CLI commands, flags, output formatting kind/docs Documentation-only changes

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@aheritier @dgageot @docker-agent