gitbutler-fleet-automations
Skill3 starsChanged 4 days agoMITView on GitHub
GitButler automations for Igor's multi-agent fleet: but skill install/check, but agent setup --print, forge/AI config, stacked PRs, absorb, session branches, isolated MCP. Overlay on gitbutler-fleet-safe. Complementary to Codex #2119 gitbutler-route (do not dual-edit it). Auto-invoke on GitButler automations, but agent, but skill, but mcp, but pr auto-merge, absorb, session branch. Slash: /gitbutler-fleet-automations.
- Commits and pushes
In this repository153 other files it gives its agents.
- AGENTS.mdAGENTS.md
- hermes-mobile/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- .cursor/rules/agent-automations.mdcCursor rule
- .cursor/rules/agent-device.mdcCursor rule
- .cursor/rules/agent-harness-router.mdcCursor rule
- .cursor/rules/agent-skills-overview.mdcCursor rule
- .cursor/rules/always-agent-mode.mdcCursor rule
- .cursor/rules/callstack-agent-skills-overview.mdcCursor rule
- .cursor/rules/callstack-react-native-best-practices.mdcCursor rule
- .cursor/rules/codeql-agent-hygiene.mdcCursor rule
- .cursor/rules/decision-stack.mdcCursor rule
- .cursor/rules/expo-credit-budget.mdcCursor rule
- .cursor/rules/fleet-repo-intelligence.mdcCursor rule
- .cursor/rules/hermes-mobile-prevention-july-2026.mdcCursor rule
- .cursor/rules/hermes-mobile-real-users.mdcCursor rule
- .cursor/rules/hermes-mobile-verification.mdcCursor rule
- .cursor/rules/no-desktop-hijack.mdcCursor rule
- .cursor/rules/no-manual-handoffs.mdcCursor rule
- .cursor/rules/obsidian-teammate-collaboration.mdcCursor rule
- .cursor/rules/prefer-headless-background-ops.mdcCursor rule
- .cursor/rules/react-native-best-practices.mdcCursor rule
- public/llms.txtllms.txt
- advertise-thumbgate-github-marketplaceSkill
- agent-harness-routerSkill
- agentic-pattern-selectorSkill
- agents-judgment-calls-gateSkill
- ai-native-sdlcSkill
- android-dev-summit-26-gateSkill
- anti-babysitting-mandateSkill
- anti-babysittingSkill
- background-agent-hold-gateSkill
- browseros-agent-harnessSkill
- webmcp-agent-readinessSkill
- ci-first-failSkill
- ci-pr-monitorSkill
- cloudflare-developer-stackSkill
- cloudflare-kitesurf-browserSkill
- cloudflare-monetization-gatewaySkill
- confidence-offer-gateSkill
- content-laneSkill
- context-six-blockSkill
- context-vaultSkill
- context-weight-gateSkill
- dual-model-agentic-graphragSkill
- egm-fresh-reviewSkill
- elevenlabs-voice-agentsSkill
- emeans-quant-and-instinctSkill
- explainx-trending-honestSkill
- explainx-trending-ragSkill
- future-agi-self-healing-engineSkill
- garryslist-opportunity-trackerSkill
- gemini-decisions-hold-gateSkill
- git-at-scaleSkill
- gitbutler-google-ssoSkill
- gitbutler-mcp-isolatedSkill
- gitbutler-session-absorbSkill
- git-hooks-no-huskySkill
- github-marketplace-action-publishSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 1 is distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 27
Do not edit tools/gitbutler-route.js (Codex PR #2119).
- Distinctive: line 70
No global Grok GitButler MCP
- Very specific: line 71
No Cursor hooks.json calling a missing but cursor
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
GitButler automations (fleet)
Official recipes (overwritten by but skill check --update): ~/.grok/skills/gitbutler.
Collision wall: [[gitbutler-fleet-safe]] / Codex #2119 tools/gitbutler-route.js.
Cloud login: [[gitbutler-google-sso]] (Google SSO personal Gmail; never GitHub for Cloud).
Companions: [[gitbutler-mcp-isolated]], [[gitbutler-session-absorb]].
CLI measured: but 0.22.1. Doctor (live 2026-08-26): exit 0, 8 skill installs, REFUSE on ThumbGate/mac-yolo/RealEstate.
node tools/gitbutler-fleet-automations.js --demo --json
node tests/test-gitbutler-fleet-automations.js
bash ~/.grok/skills/gitbutler-fleet-automations/scripts/doctor.shDo not edit tools/gitbutler-route.js (Codex PR #2119). This skill is the doing layer.
Examples (show, don't tell)
Weak: Use but for all git writes.
Gold:
$ bash ~/.grok/skills/gitbutler-fleet-safe/scripts/assert_but_setup_safe.sh
REFUSE: 84 worktrees on .git. Never but setup on a multi-worktree repo.
$ node tests/test-gitbutler-fleet-automations.js
test-gitbutler-fleet-automations: PASSLayer order
gitbutler-fleet-safe/gitbutler-route— MAY I usebuthere? Exit 1 =git+ isolated worktree.- This skill — HOW this fleet automates.
- Official
butskill — exact flags / CLI IDs.
Automations we run
| Automation | Command | Fleet rule |
| Skill install (global) | but skill install --global / --detect | 8 agent formats at CLI version. Never put fleet rules in the official SKILL.md |
| Skill freshness | but skill check | --update overwrites official skill only |
| Agent steering | but agent setup --print | TTY wizard is but agent setup. Do not paste into sibling AGENTS.md |
| Session branch | but commit -b agent/<slug> -m "…" <ids> | Isolated GitButler clone only. Linked worktrees use git |
| Absorb | but absorb <hunk-id> | Unpublished own commit. Never another agent's branch |
| Undo | but undo / but oplog | Prefer over reflog |
| Stacked PRs | but pr new <top-branch> | Isolated clone. gh pr create breaks stack metadata |
| Auto-merge | but pr auto-merge | Same as gh: never around ThumbGate protection |
| Land | but land | NEVER on ThumbGate / mac-yolo main |
| MCP | scripts/mcp_isolated.sh | but mcp serve after assert_but_setup_safe.sh exit 0. Do not add [mcp_servers.gitbutler] to ~/.grok/config.toml |
| Cursor hooks | but cursor | Missing on CLI 0.22.1 (unrecognized subcommand). Do not write ~/.cursor/hooks.json for it |
| Pre-push hooks | default on but push / but pr new | --no-hooks only for a proven false deny |
Rubric
but --version= 0.22.1but skill check→ 8 installs, all up to datedoctor.shexit 0 and REFUSE on ThumbGate / mac-yolo / RealEstate- No global Grok GitButler MCP
- No Cursor hooks.json calling a missing
but cursor - Complementary to #2119, files not dual-edited
Igor's standing ship mandate overrides GitButler's "do not push unless asked" once the task already includes PR/push.
Related
- [[gitbutler-fleet-safe]]
- [[gitbutler-mcp-isolated]]
- [[gitbutler-session-absorb]]
- [[gitbutler-google-sso]]
- Official:
~/.grok/skills/gitbutler/SKILL.md
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

