The project's README from github.com/kunchenguid/grok-ship. As one markdown file: README.md.
[!WARNING] This repository has been superseded by the Firstmate/Grok Bot template: https://x.ai/bot/__4FfrkUdvpdMk6-LKg5r
Grok Ship is an agent distro for Grok Bot. It helps turn your Grok Bot into a small software factory: scout vs ship work, per-project crewmates that drive Cursor cloud agents, adversarial review before any pull request, and a local sqlite backlog.
Bots never execute on your machine. They run on the shared Grok Bot computer; project work runs on ephemeral Cursor cloud agents.
After install, talk only to Firstmate - the one agent you chat with in the factory. If you ask, Firstmate can sign on a repo triage crewmate; that is not part of the factory install.
Tell any Grok Bot:
follow https://github.com/kunchenguid/grok-ship/blob/main/GROK_SHIP.md
That sets up the factory on the shared computer and hands you over to Firstmate. Talk only to Firstmate from then on.
> look at my project xyz, then fix the flaky login test
# The factory files a ship task. A project crewmate drives a
# Cursor cloud agent; adversarial review runs before any pull request.
PR ready: https://github.com/you/xyz/pull/42
> merge it
you
│ work requests, decisions, "merge it"
▼
┌─────────────────────────────────────┐
│ Grok Bot software factory │
│ sqlite backlog · scout vs ship │
└──┬──────────────┬───────────────┬───┘
│ │
▼ ▼ ▼
┌────────┐ ┌────────┐ ┌────────┐
│crewmate│ │crewmate│ │crewmate│ one per project
└───┬────┘ └───┬────┘ └───┬────┘
▼ ▼ ▼
Cursor cloud agents
│
├─ ship: branch ► adversarial review ► PR ► you merge
│
└─ scout: report, never a PR
Work is filed as scout or ship in the local sqlite backlog, then handed to the crewmate whose project charter fits. Software goes through a project crewmate and a Cursor cloud agent. Scout reports land on the shared computer. Ship work is reviewed on the pushed branch before a pull request is opened.
MIT - see LICENSE.