Skip to content

docs: document --session-read-only flag for TUI read-only mode#3028

Open
aheritier wants to merge 1 commit into
mainfrom
docs/auto-update
Open

docs: document --session-read-only flag for TUI read-only mode#3028
aheritier wants to merge 1 commit into
mainfrom
docs/auto-update

Conversation

@aheritier

Copy link
Copy Markdown
Contributor

Documentation updates

This PR documents the --session-read-only flag introduced by #3026.

Changes

Commit Source PR What changed
9092b7d8 #3026 Add --session-read-only to CLI reference flags table; add usage examples in CLI and TUI docs

Details

docs/features/cli/index.md — Added --session-read-only row to the docker agent run flags table (after --session-db), and added a combined --session -1 --session-read-only example to the Examples block.

docs/features/tui/index.md — Added a commented example to the "Launching the TUI" code block showing how to open a past session in read-only mode.

Behavior documented

  • Opens the TUI in read-only mode: conversation history is displayed but no new messages can be sent to the LLM
  • Editor shows a "Session is read-only" placeholder
  • Attempting to send a message shows a warning notification
  • Slash commands (e.g. /exit, /compact) still work in read-only mode
  • File attachments are also blocked
  • Cannot be used with --exec (returns an error)
  • Most useful when combined with --session to review past conversations without accidentally sending new messages

PRs reviewed and found up to date

Source PR Reason
#3025 Docs-only PR — all changes applied within the PR itself
#3012 Docs-only PR — all changes applied within the PR itself
#3007 Bug fix only (preserve agent field during command expansion) — docs already correctly describe intended behavior
#3006 Internal implementation detail (skip binary files in content search) — no user-facing behavior change

Add --session-read-only to the CLI reference flags table and add
usage examples in both the CLI reference and TUI feature docs.

Closes #3026
@aheritier aheritier requested a review from a team as a code owner June 9, 2026 04:04
@aheritier aheritier added the kind/docs Documentation-only changes label Jun 9, 2026

@docker-agent docker-agent left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assessment: 🟢 APPROVE

This documentation PR accurately describes the --session-read-only flag behavior. The changes are factually correct, consistent with the existing documentation style, and the example commands are valid.

Summary of changes reviewed:

  • docs/features/cli/index.md: New --session-read-only flag row added to the flags table; new example command added to the Examples block
  • docs/features/tui/index.md: New commented example added to the "Launching the TUI" code block

No issues found in the changed code.

@aheritier aheritier added the area/tui For features/issues/fixes related to the TUI label Jun 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/tui For features/issues/fixes related to the TUI kind/docs Documentation-only changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants