Skip to content

docs: install the CLI via the install script#11839

Closed
jd wants to merge 5 commits into
devs/jd/worktree-update-stacks/extract-shared-install-snippets-partials--54a063e7from
devs/jd/worktree-update-stacks/install-cli-via-install-script--0a67ad63
Closed

docs: install the CLI via the install script#11839
jd wants to merge 5 commits into
devs/jd/worktree-update-stacks/extract-shared-install-snippets-partials--54a063e7from
devs/jd/worktree-update-stacks/install-cli-via-install-script--0a67ad63

Conversation

@jd

@jd jd commented Jun 15, 2026

Copy link
Copy Markdown
Member

Switch the documented install method to the standard one-line installer
(curl -fsSL https://raw.githubusercontent.com/Mergifyio/mergify-cli/main/install.sh | sh)
and drop the uv/pipx/Homebrew alternatives. Updates the CLI page, the
shared stacks install partials, the agents bootstrap, and the gh-stack
distribution note.

Co-Authored-By: Claude Opus 4.8 (1M context) noreply@anthropic.com

Depends-On: #11826

jd and others added 4 commits June 13, 2026 21:21
Replace the git rebase -i flows in the Updating Stacks guide with the
dedicated non-interactive subcommands the CLI now ships:
edit/reword/reorder/move/drop/fixup/squash, each with --dry-run.

Document the revision-history comment and `mergify stack note`, add a
revision-history section (and browser-extension screenshot) to the
reviewing guide, add the stack-revision-history git config option, and
use `mergify stack sync` after a merge instead of a bare re-push.

Refresh the stack-comment screenshot to the current table layout, fix
stale "interactive rebase" rows in the gh-stack and Graphite comparison
tables, and soften the landing-page claim that there are no new commands
to learn.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Change-Id: I084ff85fe6c9214271eaa9d4bd0d9620777d540a
Add an honest comparison between Mergify Stacks and stacking by hand
with `git rebase` + `gh pr create`, the baseline every other stacking
tool is measured against.

Covers the manual recipe and its upkeep cost, a feature-by-feature
table, a candid "when plain Git is enough" section, where Stacks pulls
ahead (self-maintaining chain, Change-Id identity across rewrites,
reviewer context, Merge Queue integration), an incremental "coming from
a custom script" path, and an explicit off-ramp note. Wire it into the
compare index grid.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Change-Id: I7f58b1226bdb39616cc81de109aa9b5ebfbedcf3
The browser extension now surfaces Stacks context (the stack chain and
revision-history timeline) in addition to merge queue controls, so
nesting it under Merge Queue no longer fits.

Relocate the page to /browser-extensions and group it with the CLI under
a new top-level Tools nav group, move its images alongside it, broaden
the content with a Stacks panel section, repoint the inbound links from
the stacks docs, and add a 301 redirect from the old URL.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Change-Id: I2e6ed322d24c29e7e1ed4e72f456b9461784952d
The install/quickstart command blocks were copy-pasted across the stacks
docs, so a command change meant editing every page. Extract three MDX
partials (_install, _install-setup, _quickstart) and use them on the
landing, setup, agents, plain-git, gh-stack, and graphite pages so the
commands live in one place.

Addresses review feedback on the "vs Plain Git" page where the install
block was duplicated.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Change-Id: I54a063e7c281920699defa903bdf82cbafe984f7
@jd

jd commented Jun 15, 2026

Copy link
Copy Markdown
Member Author

This pull request is part of a Mergify stack:

# Pull Request Link
1 docs(stacks): sync stacks docs with current CLI #11820
2 docs(stacks): add "vs Plain Git" comparison page #11822
3 docs: move Browser Extensions out of the Merge Queue section #11825
4 refactor(stacks): extract shared install snippets into partials #11826
5 docs: install the CLI via the install script #11839 👈

@mergify

mergify Bot commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

Merge Protections

Your pull request matches the following merge protections and will not be merged until they are valid.

🔴 ⛓️ Depends-On Requirements

Waiting for

This rule is failing.

Requirement based on the presence of Depends-On in the body of the pull request

🔴 👀 Review Requirements

Waiting for

  • #approved-reviews-by >= 2
This rule is failing.
  • any of:
    • #approved-reviews-by >= 2
    • author = dependabot[bot]
    • author = mergify-ci-bot

🔴 🔎 Reviews

Waiting for

  • #review-requested = 0
This rule is failing.
  • #review-requested = 0
  • #changes-requested-reviews-by = 0
  • #review-threads-unresolved = 0

🟢 🤖 Continuous Integration

Wonderful, this rule succeeded.
  • all of:
    • check-success = build
    • check-success = lint
    • check-success = test
    • any of:
      • check-success = test-broken-links
      • label = ignore-broken-links
    • any of:
      • check-success=Cloudflare Pages
      • -head-repo-full-name~=^Mergifyio/

🟢 Enforce conventional commit

Wonderful, this rule succeeded.

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

  • title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert|ui)(?:\(.+\))?:

🟢 📕 PR description

Wonderful, this rule succeeded.
  • body ~= (?ms:.{48,})

@mergify mergify Bot had a problem deploying to Mergify Merge Protections June 15, 2026 16:00 Failure
@mergify mergify Bot requested a review from a team June 15, 2026 16:10
@jd jd marked this pull request as ready for review June 15, 2026 16:12
Switch the documented install method to the standard one-line installer
(`curl -fsSL https://raw.githubusercontent.com/Mergifyio/mergify-cli/main/install.sh | sh`)
and drop the uv/pipx/Homebrew alternatives. Updates the CLI page, the
shared stacks install partials, the agents bootstrap, and the gh-stack
distribution note.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Change-Id: I0a67ad63cdb6eff97e561cb0bee68f4ef96a1f5f
@jd jd force-pushed the devs/jd/worktree-update-stacks/install-cli-via-install-script--0a67ad63 branch from 49cd314 to 4f39217 Compare June 15, 2026 16:16
@jd

jd commented Jun 15, 2026

Copy link
Copy Markdown
Member Author

Revision history

# Type Changes Reason Date
1 initial 49cd314 2026-06-15 16:16 UTC
2 content 49cd314 → 4f39217 (raw) document mergify self-update alongside the install script 2026-06-15 16:16 UTC

@mergify mergify Bot had a problem deploying to Mergify Merge Protections June 15, 2026 16:16 Failure
@jd jd force-pushed the devs/jd/worktree-update-stacks/extract-shared-install-snippets-partials--54a063e7 branch from 32eea54 to 46a4950 Compare June 16, 2026 14:45
@jd jd closed this Jun 16, 2026
@jd jd deleted the devs/jd/worktree-update-stacks/install-cli-via-install-script--0a67ad63 branch June 16, 2026 14:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant