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…

Что это?Grok Ship — дистрибутив агентов для Grok Bot, превращающий его в небольшую фабрику ПО: он регистрирует, делегирует и доводит работу до конца через crewmates, закреплённых за проектами и управляющих облачными агентами Cursor, с состязательным ревью перед каждым pull request.
Это устанавливается на мой компьютер или работает где-то ещё?Он работает на общем компьютере Grok Bot, а не на вашей машине — боты никогда не исполняются локально. Сама работа над проектом идёт на временных облачных агентах Cursor, а после настройки вы общаетесь только с одним координирующим агентом по имени Firstmate.
Как запустить фабрику?Попросите любого Grok Bot её настроить: это сконфигурирует фабрику на общем компьютере и передаст вас Firstmate — единственному агенту, с которым вы дальше взаимодействуете.
Что нужно перед использованием — только Grok Bot?Нужны Grok Bot и доступ к облачным агентам Cursor, которыми crewmates управляют, чтобы реально выполнять работу; также нужен подключённый forge-репозиторий.
Проект ещё поддерживается?Нет — в репозитории висит предупреждение, что его вытеснил шаблон Firstmate/Grok Bot, так что это фактически устаревший предшественник, а не рекомендуемая сейчас схема.
Что означают scout и ship?Работа scout — это исследование, диагностика, планирование или аудит, и она всегда даёт отчёт, но не PR; работа ship — санкционированное изменение, которое может завершиться pull request. Перевод scout-задачи в ship меняет ту же строку задачи, а не создаёт дубликат.
Кто такой Firstmate?Firstmate — единственный координирующий агент, с которым вы общаетесь на фабрике после настройки; он регистрирует работу и направляет её нужному crewmate проекта.
С какими платформами хостинга кода он работает?Он не привязан к конкретной forge и определяет GitHub, GitLab, Bitbucket или Cursor Origin, а не считает по умолчанию, что это GitHub.
Size
<0.1 MB
Stars
189
Updated
CommitSep 06
Age
1mo
Commits · 90 Days