create-sidclaw-app
Scaffold a new SidClaw-governed agent project with one command.
create-sidclaw-app
Scaffold a complete governed agent project with one command. The CLI creates a working project with a registered agent, 3 demo policies, and a runnable governance example.
Usage
npx create-sidclaw-app my-governed-agentThe interactive CLI walks you through:
- Project name — directory name for the new project
- Framework — choose from 7 templates
- API key — paste an existing key or sign up at app.sidclaw.com
- API URL — defaults to
https://api.sidclaw.com(change for self-hosted)
Framework Templates
| Template | Language | What it creates |
|---|---|---|
| LangChain (Python) | Python | LangChain agent with governed tool wrappers |
| LangChain.js | TypeScript | LangChain.js agent with governTools() |
| Vercel AI SDK | TypeScript | Next.js chat app with governed Vercel AI tools |
| OpenAI Agents | Python | OpenAI Agents SDK with governed function tools |
| MCP Proxy | TypeScript | MCP governance proxy wrapping an upstream server |
| Plain TypeScript | TypeScript | Minimal SDK example with withGovernance() |
| Plain Python | Python | Minimal SDK example with with_governance() |
What Gets Created
For each template, the CLI:
- Scaffolds the project — creates the directory with framework-specific code
- Registers an agent — calls the SidClaw API to create an agent identity
- Creates 3 demo policies:
- Allow read operations (auto-approve)
- Require approval for write operations
- Deny delete operations in production
- Writes config — saves the API key and agent ID to
.env - Installs dependencies — runs
npm installorpip install
Running the Scaffolded Project
cd my-governed-agent
# TypeScript templates:
npm start
# Python templates:
python main.pyOpen the SidClaw dashboard to see the approval requests and audit traces generated by the demo.
Non-Interactive Mode
Pass all options as CLI arguments:
npx create-sidclaw-app my-agent \
--framework langchain-python \
--api-key ai_... \
--api-url https://api.sidclaw.comRequirements
- Node.js 18+ (for running
npx) - For Python templates: Python 3.10+
- A SidClaw API key (get one at app.sidclaw.com or from a self-hosted instance)