Skip to content

README.md

Latest commit

 

History

History
132 lines (93 loc) · 4.45 KB

README.md

File metadata and controls

132 lines (93 loc) · 4.45 KB

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.