Turn an idea into shipped software — on your machine, with your agents.

Creation is a local-first agent operating system. You describe what you want built — a new product, a feature in an existing repo, a fix, a launch — and Creation runs a full autonomous loop: research the problem, plan the work, write code with the terminal agent you already use, test it, sync to GitHub and Linear, and notify you when it ships.

Everything runs on your hardware for builds. Your Codex, Claude Code, Cursor, or Gemini CLI stays on your PATH. Creation Cloud (creation.dev) hosts your account, API key, credits, and Forge planning — so you sign in once and the CLI syncs automatically.

Open Creation Studio locally, or drive everything from the terminal UI.

  Your idea
      │
      ▼
┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  Research   │ ──▶ │ Plan & brand │ ──▶ │ Agent loop  │
│  (once)     │     │              │     │ code·QA·ship│
└─────────────┘     └──────────────┘     └──────┬──────┘
                                                │
                    ┌───────────────────────────┘
                    ▼
            GitHub · Linear · notify

1. Kickoff — Creation researches your idea and drafts a build plan and product name.
2. Loop — Each turn: recall memory, compress context, invoke your coding agent, run pytest and browser QA, sync through Relay.
3. Ship — Progress lands on GitHub and Linear; Pulse can queue launch comms when you're ready.

The loop is built for long runs (up to 200 turns) with token-aware context compression so agents stay within budget without losing critical detail.

curl -fsSL https://creation.dev/install | bash

This installs Creation, points the CLI at Creation Cloud (CREATION_CLOUD_URL), and launches the setup wizard.

Or create an account at creation.dev/account first, then install.

pip install git+https://github.com/desenyon/creation.git
export CREATION_CLOUD_URL=https://creation.dev
creation setup

Use creation setup --yes for non-interactive defaults, or creation setup --reinstall to run the wizard again.

creation login
creation serve

Open http://127.0.0.1:8787/dashboard — Creation Studio.

creation build "A CLI that turns Linear issues into markdown files"
creation build --demo "Todo app in Python"          # no live keys needed
creation build -C ~/code/my-app "Add OAuth login"   # edit existing repo

creation serve    # in one tab
creation          # or: creation tui — in another tab

Creation ships with a complete first-party stack — no external SaaS bundles required. One login, one credit balance, one design language.

These are selling points, not dependencies you wire up yourself. They are maintained as part of Creation and exposed through Studio, the CLI, and /api/*.

The marketing site and hosted APIs live at creation.dev — deployed from the website/ Next.js app.

Cloud API endpoints

Deploy the website

cd website && npm install && npm run build
vercel --prod   # link repo root; uses vercel.json

Link Vercel KV in the project dashboard for persistent accounts. Set OPENAI_API_KEY on Vercel for stronger Forge responses.

All state lives under ~/.creation/:

For live ships, connect in Studio → Relay:

• GitHub — personal access token with repo scope
• Linear — API key from Linear settings
• Notify email — where Pulse sends progress

Demo mode skips live Relay and still exercises the full loop.

Run creation doctor to see what's on your PATH. Set default in Studio or config.json:

{ "default_agent": "codex" }

See creation/agents/registry.py for the full list of supported CLIs.

git clone https://github.com/desenyon/creation.git
cd creation
./bootstrap.sh
source .venv/bin/activate
pytest tests -q
creation doctor
creation serve

creation/
├── website/           # Next.js site + Vercel API routes
├── cloud/             # Python client for Creation Cloud
├── account/           # Auth, credits (local fallback)
├── services/          # Forge, Lens, Prism, Relay, Pulse
├── agents/            # Coding CLI adapters
├── orchestrator.py    # Multi-turn build loop
├── server.py          # FastAPI + Studio (local)
└── app/               # Studio static assets

See CONTRIBUTING.md. Issues and PRs welcome — especially Studio UX, agent adapters, Relay targets, and Prism policies.

See SECURITY.md. Report vulnerabilities privately via GitHub Security Advisories.

MIT — see LICENSE.

_{Creation · Cloud account · Local builds · Your agents}