create-keel-app

Scaffold a new Keel project with all conventions pre-wired.

Usage

npx create-keel-app <project-name>
npx create-keel-app <project-name> --template ai-app   # default
npx create-keel-app <project-name> --template framework

The default template (ai-app) creates a project with a working MCP tool server, thin-slice agent, architecture map, and all Keel conventions in place. The framework template creates a minimal framework-only scaffold without the agent and MCP demo wiring.

Options

--template <name>

Choose a project template. Valid values: ai-app (default) or framework.

--local <path-to-keel>

Point the scaffolded project at a local Keel checkout via link: deps (pnpm link: protocol, also supported in npm 8+) instead of "*" npm version placeholders. Use this when the @keel_flow/* packages are not yet published to npm.

npx create-keel-app my-project --local /path/to/keel

The resulting package.json will have entries like:

"@keel_flow/core": "link:/path/to/keel/packages/core"

Running pnpm install inside the scaffolded project will then resolve all @keel_flow/* deps from your local checkout immediately, with no publish step required.