From 8046d850b53fd47c3977baa009a0e126781170e4 Mon Sep 17 00:00:00 2001 From: bymle Date: Fri, 12 Jun 2026 12:16:55 +0800 Subject: [PATCH] docs(faq): correct rebase FAQ to match actual behavior (#1370) The "Why won't Claude rebase my branch?" FAQ told users they could enable rebasing by passing `--allowedTools "Bash(git rebase:*)"` via claude_args. This does not work: the system prompt built in src/create-prompt/index.ts unconditionally instructs Claude that it cannot merge, rebase, or perform branch operations beyond creating and pushing commits, so Claude declines rebase requests regardless of the allowed tools. Update the FAQ to describe the actual behavior and point users to the real workaround (rebase locally or via the Claude Code CLI). Closes #1286 Co-authored-by: bymle <229636660+bymle@users.noreply.github.com> --- docs/faq.md | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) 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?