docs: document the full openers config schema

[ChampPABA]

docs/cli.md says the openers key "adds tools or adjusts built-ins per field", but it never lists the fields, and the example only shows style and attach_flag. The schema in src/core/openers.ts accepts five: style, label, command, args, attach_flag.

args is the one that gets missed. It already covers "pass static flags to the launched tool" (the built-in codex opener uses it to ship --sandbox workspace-write), but because it is undocumented, the two-field example reads as the whole schema and the capability gets filed as missing (#1347).

Adds a field table under the existing example, and extends the example to show args on claude.

Docs only, no behavior change.

Summary by CodeRabbit

• Documentation
  • Updated the Personal worksets configuration example for the Claude tool to use a richer openers structure.
  • Added/clarified documentation for an args option to pass static pre-arguments to tools.
  • Clarified how tool-picker entries behave for built-in tools versus when new tools are added.

[coderabbitai]

Warning

Review limit reached

@clay-good, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 5 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: b2924c4e-f6fd-487f-bfa7-2a20ef38e110

📥 Commits

Reviewing files that changed from the base of the PR and between e50bd09 and 45c04ae.

📒 Files selected for processing (1)

• docs/cli.md

📝 Walkthrough

Walkthrough

The CLI documentation updates the Claude opener example to include an args array and clarifies the args and attach_flag configuration fields.

Changes

CLI opener documentation

Layer / File(s)	Summary
Document opener configuration docs/cli.md	The Claude openers example adds an args array, and the field reference explains args, attach_flag, and built-in tool-picker behavior.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Suggested reviewers: tabishb

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the docs-only change to the openers config schema.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/cli.md`:
- Around line 368-374: Update the “claude” CLI example to avoid silently
disabling permission checks: replace “--dangerously-skip-permissions” with a
neutral example flag, or add an explicit warning that it is only appropriate for
trusted or sandboxed workspaces.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: f0cac2bd-7876-4eb0-9213-f60b3d9dbfe7

📥 Commits

Reviewing files that changed from the base of the PR and between 0a99f41 and 6a2cc2f.

📒 Files selected for processing (1)

• docs/cli.md

[ChampPABA]

Good catch, fixed in 2c26e4b. The example now uses ["--model", "opus"], which demonstrates args just as well without putting a permission-bypass flag in the docs.