@domount/shuttle

Local agentic app framework — Express backend, JSON store, Cursor agent runners, verification gates, and scaffolds.

Docs: domount.github.io/shuttle

Install

npm install @domount/shuttle

Or scaffold a full app:

npx @domount/create-shuttle my-app

Exports

| Import | Purpose | |--------|---------| | @domount/shuttle/store | JSON file store (createStore) | | @domount/shuttle/server | Express helpers (createApp, loadEnv, asyncHandler) | | @domount/shuttle/agent | Request queue, agent runners, settings registry | | @domount/shuttle/verify | Tiered verification entrypoint | | @domount/shuttle/verify/boundaries | Import boundary checks | | @domount/shuttle/verify/tier | Tier 0–3 verify runner | | @domount/shuttle/scaffold | Feature, API, and skill scaffolds | | @domount/shuttle/eslint-config | Shared ESLint config for Shuttle apps |

CLI binaries

| Command | Purpose | |---------|---------| | shuttle-verify | Run tiered verification | | shuttle-check-boundaries | Check import boundaries | | shuttle-scaffold-feature | Scaffold a web feature page | | shuttle-scaffold-api | Scaffold server routes + service | | shuttle-scaffold-skill | Scaffold an agent skill |

Architecture

Shuttle apps combine a normal backend (Express + JSON store) with a smart agent backend (skills, memory, request queue, Cursor runners) and a React web client.

Web (React) → /api → Express
                         ↓
                    data/ + memory/
                         ↑
              Agent (skills + AGENT.md)

See the architecture guide for layers, configuration, and verification.

Requirements

• Node.js >= 18
• Optional: @cursor/sdk for the Cursor SDK agent runner

License

MIT