diff --git a/docs/faq.md b/docs/faq.md index b491343f..e2568844 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -63,17 +63,14 @@ The GitHub App for Claude doesn't have workflow write access for security reason ### Why won't Claude rebase my branch? -By default, Claude only uses commit tools for non-destructive changes to the branch. Claude is configured to: +Claude only creates and pushes commits. It does not merge branches, rebase, force push, or perform other destructive git operations. Specifically, Claude is configured to: - Never push to branches other than where it was invoked (either its own branch or the PR branch) - Never force push or perform destructive operations -You can grant additional tools via the `claude_args` input if needed: +This restriction is enforced in Claude's system prompt, so it applies even if you grant the underlying git tools (for example `--allowedTools "Bash(git rebase:*)"`). In that case Claude will still decline rebase requests and explain the limitation rather than running the command. -```yaml -claude_args: | - --allowedTools "Bash(git rebase:*)" # Use with caution -``` +If you need to rebase, do it yourself locally — or with the Claude Code CLI outside of this action — and push the result. ### Why won't Claude create a pull request?