//operator handbook · 00 · introduction

What Moonshift is, in one page

Moonshift is an OpenCode-native multi-agent swarm that takes one sentence and ships a real, owned web app - with a deploy URL, a GitHub repo, and human-approved launch copy.

The core loop

You type /moonshift "your idea" into OpenCode. A 14-agent swarm runs a 10-phase pipeline over the next ~8 minutes. At the end, you walk away with:

  • A live Vercel deployment URL for the generated app.
  • A GitHub repository pushed to your account, with the orchestrator's commit history.
  • A marketer/COPY.json with a 270-character tweet and an 800–1300 character LinkedIn post in your founder voice.
  • Three publication-ready PNGs from image-gen - square, landscape, portrait.
  • A publisher/PENDING.json waiting for your approval. Approve from the dashboard and Moonshift posts to X and LinkedIn for you. Skip it and nothing leaves your machine.

Why it's different

Most "build me an app" demos stop at a code sandbox. Moonshift finishes the job - it deploys, it commits, it drafts launch copy, and it gates every outbound action behind your approval.

  • Owned outputs. The repo lives in your GitHub. The deployment lives in your Vercel. Moonshift writes, never keeps.
  • Real HITL. Publishing is behind a two-step approval flow. No autopilot posting.
  • Self-stopping. Every run has a budget cap with per-phase accounting. Blow the cap, the swarm halts.
  • Resumable. Kill the process and relaunch with MOONSHIFT_RESUME=1 - phases pick up where they left off.

What's inside

Moonshift is a Bun + TypeScript orchestrator that drives a DAG of markdown-defined agents. The dashboard is a Next.js 14 app with Better Auth and Drizzle over LibSQL. The plugin surface is a tiny TypeScript file that registers the slash command with your IDE.

  • agents/ - one markdown file per agent (planner, db, backend, frontend, tests, contract, deployer, audit, audit-fixer, marketer, image-gen, design, publisher).
  • orchestrator/ - the phase DAG, parallel fan-out, contract validator, resumer, and SSE event bus.
  • templates/ - the Next.js + Better Auth + Drizzle starter the agents fork per run.
  • web/ - this console, where runs stream live, showcase artifacts, and HITL approvals happen.
  • .opencode/ - the OpenCode plugin + slash command.