Skip to content

Docs: Clarify CLI modes and context length - #37

Merged
agentcooper merged 2 commits into
mainfrom
docs/v1.0.15
Aug 5, 2026
Merged

Docs: Clarify CLI modes and context length#37
agentcooper merged 2 commits into
mainfrom
docs/v1.0.15

Conversation

@amypoolside

Copy link
Copy Markdown
Collaborator

Summary

  • Split approval modes and Build/Plan agent modes into separate README sections.
  • Document how to enter and leave Plan mode, including the absence of a Plan-mode startup flag.
  • Clarify that POOLSIDE_STANDALONE_CONTEXT_LENGTH controls automatic compaction thresholds and does not change the model server context window.

Verification

  • git diff --check
  • Reviewed the documented commands and environment-variable behavior against the v1.0.15 implementation.

@amypoolside
amypoolside requested review from agentcooper and a lite review from Copilot August 4, 2026 23:41
@amypoolside amypoolside changed the title Clarify CLI modes and context length Docs: Clarify CLI modes and context length Aug 4, 2026

Copilot AI 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.

Pull request overview

This PR updates the README to better distinguish between (1) tool-approval behavior and (2) the agent’s build/plan operating mode, and clarifies what POOLSIDE_STANDALONE_CONTEXT_LENGTH actually controls in standalone mode.

Changes:

  • Split the former “Modes” documentation into separate “Approval modes” and “Agent modes” sections, with updated TOC entries.
  • Document how to enter/exit Plan mode after startup (and that there is no Plan-mode startup flag).
  • Clarify that POOLSIDE_STANDALONE_CONTEXT_LENGTH affects automatic compaction thresholds rather than the model server’s actual context window.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated

Copilot AI 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.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

Suppressed comments (1)

README.md:75

  • The /mode argument placeholder is ambiguous: the table uses an ID column (e.g. accept-edits, always-allow), but /mode <approval-mode> could be interpreted as the human-readable name (e.g. “Always ask”). Consider naming the placeholder to match the table’s ID terminology to avoid confusion.
Press `Shift+Tab` to cycle through approval modes, or use `/mode <approval-mode>` to switch directly.

@agentcooper
agentcooper merged commit 9a8c4f7 into main Aug 5, 2026
1 check passed
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.

3 participants