ShipMachine

Describe what you want. Get working code. One command.

ShipMachine is an AI engineering agent that turns plain English into shipped code. No boilerplate, no setup wizards — just describe what you want and ShipMachine plans it, builds it, and delivers it.

Every LLM call is mediated by PromptOS — no raw prompting, full governance, deterministic pipelines.

---

Quick Start

# 1. Clone
git clone https://github.com/lelandsequel/shipmachine.git
cd shipmachine

# 2. Install
npm install

# 3. Set your API key
export ANTHROPIC_API_KEY=sk-ant-...

# 4. Ship something
npx shipmachine ship "Build a budget tracker app with categories and charts"

That's it. ShipMachine will:

1. Plan — Claude analyzes your request and builds a structured plan (architecture, tech stack, files, steps)
2. Review — You see the plan and approve, edit, or cancel
3. Ship — ShipMachine executes the full build with enterprise guardrails

---

Two Modes

Simple Mode (recommended)

shipmachine ship "Build a landing page for a roofing company"

Plain English in, working code out. Three steps: describe → review → ship.

Developer Mode

shipmachine run-task --repo ./myapp --objective "Add auth with JWT + refresh tokens"

Full control: specify repo, objective, role, dry-run, and more.

---

One-Line Install

git clone https://github.com/lelandsequel/shipmachine.git && cd shipmachine && npm install && echo "Done! Run: npx shipmachine ship \"your idea\""

Or with npx (no install):

ANTHROPIC_API_KEY=sk-ant-... npx shipmachine ship "your idea here"

---

Web UI

Try the plan step online at clprompt.com → Ship tab.

The web version generates AI-powered build plans. Full execution requires local install.

---

What It Builds

ShipMachine handles full-stack projects:

• Web apps — React, Next.js, vanilla JS
• APIs — Express, Fastify, serverless
• CLI tools — Node.js, Python
• Landing pages — with proper design and copy
• Dashboards — data visualization, charts
• Whatever you describe

---

Architecture

┌─────────────────────────────────────────────────────┐
│                  CONTROL PLANE                       │
│  Policy Rules · RBAC · Budgets · Allowed Tools       │
└──────────────────┬──────────────────────────────────┘
                   │
┌──────────────────▼──────────────────────────────────┐
│               PROMPTOS BRIDGE                        │
│  Every LLM call → PromptSpec → Schema Validation     │
└──────────────────┬──────────────────────────────────┘
                   │
┌──────────────────▼──────────────────────────────────┐
│              ORCHESTRATOR                             │
│  Scope → Survey → Plan → Execute → Docs → Ship      │
└──────────────────┬──────────────────────────────────┘
                   │
┌──────────────────▼──────────────────────────────────┐
│                  TOOLS                                │
│  Filesystem · Git · Exec · Tests · PR                │
└─────────────────────────────────────────────────────┘

---

Requirements

• Node.js 18+
• Anthropic API key (ANTHROPIC_API_KEY)

---

Config

ShipMachine uses sensible defaults. Override with flags:

shipmachine ship "..." --repo ./my-project --dry-run
shipmachine run-task --objective "..." --repo . --role engineer

---

Built by

JourdanLabs × C&L Strategy

Part of the PromptOS ecosystem: governance-first AI engineering.