grok-ship README

The project's README from github.com/kunchenguid/grok-ship. As one markdown file: README.md.

Grok Ship

Platform X Discord

[!WARNING] This repository has been superseded by the Firstmate/Grok Bot template: https://x.ai/bot/__4FfrkUdvpdMk6-LKg5r

Turn your Grok Bot into a software factory.

What it is

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.

Features

Quick Start

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

How It Works

            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.

License

MIT - see LICENSE.

grok-ship (kunchenguid/grok-ship)

Searching Database…

189 ·GitHub
Grok-ship
这是什么？Grok Ship 是 Grok Bot 的一个代理发行版，把它变成一个小型软件工厂：它通过每个项目各自的船员（crewmate）登记、委派和交付工作，这些船员驱动 Cursor 云端代理，并在任何拉取请求之前做对抗式审查。
这是装在我自己电脑上的东西，还是在别处运行？它运行在共享的 Grok Bot 电脑上，而不是你的机器——机器人从不在本地执行。实际的项目工作在临时的 Cursor 云端代理上运行，配置完成后你只和一个叫 Firstmate 的协调代理打交道。
怎么把工厂跑起来？让任意一个 Grok Bot 去搭建；它会在共享电脑上配置好工厂，然后把你交给 Firstmate——从那以后你只需要和这一个代理交互。
使用前需要准备什么——只有一个 Grok Bot 就行吗？你需要一个 Grok Bot 和 Cursor 云端代理的访问权限，各项目的船员会驱动这些云端代理去真正干活；还需要连接一个 forge 仓库。
这个项目还在维护吗？不在维护。仓库带有警告，说明它已被 Firstmate/Grok Bot 模板取代，所以它实际上是一个已弃用的前身，而不是目前推荐的方案。
scout 和 ship 是什么意思？scout 工作是调查、诊断、规划或审计，只会产出报告，绝不会产出 PR；ship 工作是经授权的变更，可能产生拉取请求。把 scout 任务提升为 ship 时，是翻转同一条任务记录，而不是创建重复项。
Firstmate 是谁？Firstmate 是搭建完成后你在工厂里对话的唯一协调代理；它负责登记工作并把工作路由给合适的项目船员。
它支持哪些代码托管平台？它与托管平台无关，会自动检测 GitHub、GitLab、Bitbucket 或 Cursor Origin，而不是默认假定是 GitHub。
What are similar projects?open-swe, orca, oh-my-subagents, eve-software-factory-template, claude-code-action, foreman, moyai, superplane
Which topics is it in?pull-request, grok, code-review, github, workflow-automation, orchestration, agent-orchestration, cursor, sqlite, deprecated, multi-agent, agents
Creator
kunchenguid
Size
<0.1 MB
Stars
189
Updated
CommitSep 06
Age
2mo
Commits · 90 Days