Skip to content

docs: add Claude Code approve mode permission routing documentation#7949

Merged
angiejones merged 4 commits intomainfrom
docs/claude-code-approve-mode
Mar 20, 2026
Merged

docs: add Claude Code approve mode permission routing documentation#7949
angiejones merged 4 commits intomainfrom
docs/claude-code-approve-mode

Conversation

@blackgirlbytes
Copy link
Copy Markdown
Collaborator

Summary

Document the new feature that routes Claude Code permission prompts through goose's confirmation interface when using approve or smart-approve mode.

What's Documented

cli-providers.md

Added a tip box after the Claude Code permission modes table explaining:

  • How approve/smart-approve mode routes permission prompts through goose's interface
  • The user experience (sensitive operations trigger prompts, review in goose CLI/Desktop, decisions sent back to Claude Code)
  • Example command to use approve mode

goose-permissions.md

Added a new "CLI Provider Permission Integration" section that:

  • Explains how goose integrates with CLI providers' native permission systems
  • Details the flow for Claude Code in approve mode
  • Notes compatibility with official Claude Agent SDKs
  • Links to the CLI providers documentation for setup details

Related

Documents the feature from #7420

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 02f3a3e60e

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

| `chat` | (none) | Default Claude Code behavior |

:::tip Approve Mode Integration
When using `approve` or `smart-approve` mode with Claude Code, goose routes Claude Code's permission prompts through goose's confirmation interface. This means:
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Use smart_approve mode name in Claude Code docs

This new guidance uses smart-approve, but GOOSE_MODE is deserialized from GooseMode with snake_case values (smart_approve) in crates/goose/src/config/goose_mode.rs; if users copy smart-approve, mode parsing fails and claude_code::apply_permission_flags falls back to GooseMode::Auto (unwrap_or(GooseMode::Auto)), which enables --dangerously-skip-permissions instead of approval prompts. That can silently disable the safety behavior this section is describing.

Useful? React with 👍 / 👎.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 17, 2026

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-03-20 15:39 UTC

Copy link
Copy Markdown
Collaborator

@DOsinga DOsinga left a comment

Choose a reason for hiding this comment

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

Docs look good! One fix pushed directly to the branch: changed smart-approve to smart_approve in the tip box prose — the enum is deserialized as snake_case so the hyphenated form would silently fall back to auto mode (which skips all permissions), which is the opposite of what this section is documenting. Everything else is accurate and clear.

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 345c8f9502

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

blackgirlbytes and others added 3 commits March 20, 2026 10:27
Document the new feature that routes Claude Code permission prompts through
goose's confirmation interface when using approve or smart-approve mode.

Updates:
- cli-providers.md: Added tip box explaining approve mode integration with
  example command
- goose-permissions.md: Added CLI Provider Permission Integration section
  explaining how goose integrates with CLI providers' native permission systems

Related to: #7420

Signed-off-by: Rizel Scarlett <[email protected]>
Signed-off-by: Angie Jones <[email protected]>
Signed-off-by: Douwe Osinga <[email protected]>
Signed-off-by: Angie Jones <[email protected]>
Co-authored-by: Angie Jones <[email protected]>
Signed-off-by: Angie Jones <[email protected]>
@angiejones angiejones force-pushed the docs/claude-code-approve-mode branch from 345c8f9 to 5ad79d5 Compare March 20, 2026 15:28
@angiejones angiejones added this pull request to the merge queue Mar 20, 2026
Merged via the queue into main with commit 8df8642 Mar 20, 2026
23 checks passed
@angiejones angiejones deleted the docs/claude-code-approve-mode branch March 20, 2026 15:38
elijahsgh pushed a commit to elijahsgh/goose that referenced this pull request Mar 21, 2026
…lock#7949)

Signed-off-by: Rizel Scarlett <[email protected]>
Signed-off-by: Angie Jones <[email protected]>
Signed-off-by: Douwe Osinga <[email protected]>
Co-authored-by: Douwe Osinga <[email protected]>
Co-authored-by: Angie Jones <[email protected]>
Co-authored-by: Angie Jones <[email protected]>
Signed-off-by: esnyder <[email protected]>
elijahsgh pushed a commit to elijahsgh/goose that referenced this pull request Mar 21, 2026
…lock#7949)

Signed-off-by: Rizel Scarlett <[email protected]>
Signed-off-by: Angie Jones <[email protected]>
Signed-off-by: Douwe Osinga <[email protected]>
Co-authored-by: Douwe Osinga <[email protected]>
Co-authored-by: Angie Jones <[email protected]>
Co-authored-by: Angie Jones <[email protected]>
Signed-off-by: esnyder <[email protected]>
wpfleger96 added a commit that referenced this pull request Mar 23, 2026
* origin/main: (62 commits)
  Tweak the release process: no more merge to main (#7994)
  fix: gemini models via databricks (#8042)
  feat(apps): Pass toolInfo to MCP Apps via hostContext (#7506)
  fix: remove configured marker when deleting oauth provider configuration (#7887)
  docs: add vmware-aiops MCP extension documentation (#8055)
  Show setup instructions for ACP providers in settings modal (#8065)
  deps: replace sigstore-verification with sigstore-verify to kill vulns (#8064)
  feat(acp): add session/set_config and stabilize list, delete and close (#7984)
  docs: Correct `gosoe` typo to `goose` (#8062)
  fix: use default provider and model when provider in session no longer exists (#8035)
  feat: add GOOSE_SHELL env var to configure preferred shell (#7909)
  fix(desktop): fullscreen header bar + always-visible close controls (#8033)
  docs: add Claude Code approve mode permission routing documentation (#7949)
  chatgpt_codex: Support reasoning and gpt-5.4 (#7941)
  refactor(anthropic): fix N+1 thinking message storage issue (#7958)
  fix: handle mid-stream error events in OpenAI SSE streaming (#8031)
  Fix apps extension: coerce string arguments from inner LLM responses (#8030)
  feat: ability to expand sidebar to see chats names  (#7816)
  Fix config for GOOSE_MAX_BACKGROUND_TASKS (#7940)
  set MACOSX_DEPLOYMENT_TARGET=12.0 (#7947)
  ...
wpfleger96 added a commit that referenced this pull request Mar 23, 2026
…pstream

* wpfleger/socket-support: (62 commits)
  Tweak the release process: no more merge to main (#7994)
  fix: gemini models via databricks (#8042)
  feat(apps): Pass toolInfo to MCP Apps via hostContext (#7506)
  fix: remove configured marker when deleting oauth provider configuration (#7887)
  docs: add vmware-aiops MCP extension documentation (#8055)
  Show setup instructions for ACP providers in settings modal (#8065)
  deps: replace sigstore-verification with sigstore-verify to kill vulns (#8064)
  feat(acp): add session/set_config and stabilize list, delete and close (#7984)
  docs: Correct `gosoe` typo to `goose` (#8062)
  fix: use default provider and model when provider in session no longer exists (#8035)
  feat: add GOOSE_SHELL env var to configure preferred shell (#7909)
  fix(desktop): fullscreen header bar + always-visible close controls (#8033)
  docs: add Claude Code approve mode permission routing documentation (#7949)
  chatgpt_codex: Support reasoning and gpt-5.4 (#7941)
  refactor(anthropic): fix N+1 thinking message storage issue (#7958)
  fix: handle mid-stream error events in OpenAI SSE streaming (#8031)
  Fix apps extension: coerce string arguments from inner LLM responses (#8030)
  feat: ability to expand sidebar to see chats names  (#7816)
  Fix config for GOOSE_MAX_BACKGROUND_TASKS (#7940)
  set MACOSX_DEPLOYMENT_TARGET=12.0 (#7947)
  ...
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