Stacked Pull Requests

Author of the stack. Defaults to the token's user

owner/repo. Falls back to the URL of --trunk's remote

Local branch name. Defaults to the normalised NAME

Override the stack branch prefix

Show the plan without checking out

Target trunk as REMOTE/BRANCH. Defaults to the resolved trunk for the current branch

GitHub token (falls back to MERGIFY_TOKEN / GITHUB_TOKEN / gh auth token)

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

Commits to drop. Each accepts a SHA prefix or a Change-Id prefix

Show the plan without dropping

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

Commit to pause the rebase on. Accepts a SHA prefix or a Change-Id prefix; omit for a fully interactive rebase

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

Show the plan without rebasing

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

Install or upgrade hooks

Force reinstall wrappers (use with --setup)

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

Emit machine-readable JSON

Show per-check / per-reviewer detail

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

Commit to move

Where to put it: first, last, before, after

Values: first last before after

Required when position is before or after

Show the plan without moving

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

Name of the new branch

Base branch to fork from, formatted as REMOTE/BRANCH (e.g. origin/main). When omitted, the trunk is resolved from the current branch's tracking info or refs/remotes/origin/HEAD

Checkout the new branch after creation. This is the default. Pass --no-checkout to keep the current branch checked out

Leave the current branch checked out and just create the new branch ref

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

Target commit. Accepts a SHA prefix, a ref (HEAD~1, branch name, …), or a Change-Id prefix (resolved against the stack walk). Defaults to HEAD

Note message. If omitted, opens $GIT_EDITOR / $VISUAL / $EDITOR / vi on a tempfile

Append to an existing note instead of replacing

Remove the note on the target commit. Mutually exclusive with --message and --append

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

Skip the rebase step. By default stack push rebases on trunk before pushing when there are no approvals to dismiss

Force the rebase even when PRs are approved (the rebase will dismiss the reviews). Mutually exclusive with --skip-rebase

Only push the bottom commit of the stack

Dry-run: render the plan + the rebase decision and exit

Open new PRs as drafts. Default falls back to git config mergify-cli.stack-create-as-draft (false when unset)

Don't rewrite the PR title + body from the commit message; only update the rendered Depends-On chain in the body. Default falls back to git config mergify-cli.stack-keep-pr-title-body (false when unset)

Don't create new PRs; surface would-be-created ones in the plan instead

Suppress the revision-history sticky comment update. Default falls back to git config mergify-cli.stack-revision-history (true when unset)

Pass --no-verify to git push (skips local pre-push hooks)

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

Show the plan without reordering

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

New message. When omitted, git rebase -i pauses at the target and opens $GIT_EDITOR

Show the plan without rebasing

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

Force reinstall of hook wrappers, even if user modified them

Check status only (use 'stack hooks' instead)

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

SRC1 SRC2 ... into TARGET — must contain exactly one into token; everything before is a source, the single token after is the target

Final commit message (required to rename; otherwise the target's message is kept)

Show the plan without rebasing

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it

Enable verbose debug logging. Mirrors the Python CLI's top-level --debug flag so the same invocations work against either binary; native commands accept it as a no-op today (no native code path consults it yet), shimmed ones re-inject it into the forwarded argv so the Python side can honor it