create-moss-app

Scaffold a new Moss agent project in seconds.

Usage

npm install create-moss-app@latest

# Using npm create
npm create moss-app my-agent

# Using npx
npx create-moss-app my-agent

# With OpenAI template
npx create-moss-app my-agent --template openai

# Skip dependency install during scaffolding
npx create-moss-app my-agent --skip-install

Templates

| Template | Description | |----------|-------------| | minimal | Minimal Moss agent with Anthropic API key support (default) | | openai | Agent with OpenAI-compatible provider (works with DeepSeek, Ollama, etc.) |

What Gets Created

my-agent/
├── package.json
├── index.ts
├── mcp.json.example
└── README.md

The generated app includes local tsx, typescript, and Node type dependencies, plus start and typecheck scripts.

Then:

cd my-agent
npm run typecheck
ANTHROPIC_API_KEY=your-key npm start

The default template uses Anthropic and also accepts MOSS_API_KEY as a compatibility fallback. The OpenAI-compatible template uses OPENAI_API_KEY.