Craft CLI Reference

Complete command reference for the Craft CLI tool

Installation

npm install -g @getcraft-dev/craft-cli

Install the Craft CLI globally to access the craft command from anywhere.

Authentication

`craft login <api_key>`

Authenticate with your Craft API key (required for all operations).

craft login craft_abc123def456...

💡 Get your API key at craft.dev/dashboard

`craft logout`

Remove stored API key from your system.

craft logout

Project Creation

`craft new`

Create a new Craft project. The CLI will guide you through template selection.

craft new

Available Templates (Pro License):

🔥 Craft Pro — $149 (Launch Offer)

• Rapid Web - Ship fast, 1-2 devs, Web only
• Rapid Web+Mobile - MVP with React Native + Expo
• Balanced Web - Pragmatic quality, Web only
• Balanced Web+Mobile - 3-layer architecture with mobile
• Crafted Web - Software craftsmanship, Web only
• Crafted Web+Mobile - Hexagonal DDD with mobile

All 6 templates included • Limited to 1,000 customers • $299 50% off

License Management

`craft license activate`

Activate a Pro or Enterprise license key.

craft license activate

# Prompts for license key

Enter license key: CRAFT-PRO-XXXX-XXXX-XXXX-XXXX-XXXX

`craft license status`

Check current license tier and access level.

craft license status

`craft license deactivate`

Deactivate license on current device (frees up a device slot).

craft license deactivate

⚠️ paid tier: Max 3 devices. Use this command to free up slots.

Code Generation

Generate boilerplate code for common patterns (available to all tiers).

`craft generate router <name>`

Generate a new tRPC router with CRUD operations.

craft generate router products

Creates: packages/api/src/routers/products.ts

`craft generate page <path>`

Generate a new Next.js page.

craft generate page /dashboard/settings

Creates: apps/web/src/app/dashboard/settings/page.tsx

`craft generate component <name>`

Generate a new React component.

craft generate component Button

Creates: apps/web/src/components/button.tsx

AI System Setup

Configure AI tooling for enhanced development (tier-restricted).

`craft setup ai`

Setup complete AI tooling (MCP servers + Skills).

craft setup ai

💎 Craft Pro — Complete AI Setup

Installs:

• 10 MCP servers (full stack: crafted-cli, crafted-context, rules-validator, architecture-guard, typescript, vitest, github, chrome-devtools, filesystem, sequential-thinking)
• 16 AI Skills (level, workflow, agent skills)
• Complete Claude Code integration

Requires Pro license ($149 launch offer)

`craft setup mcp`

Install MCP servers only (no skills).

craft setup mcp

`craft setup skills`

Install Claude Code Skills only.

craft setup skills

💎 Pro license required ($149 launch offer). Get yours at getcraft.dev/checkout

What's Included with Craft Pro

Everything you need to ship SaaS 10x faster - one-time payment, lifetime updates.

Feature	💎 Craft Pro
Templates	6 templates (All 3 levels × Web + Mobile)
Quality Levels	Rapid, Balanced, Crafted
AI Skills	16 skills (level, workflow, agent)
MCP Servers	10 pre-configured servers
Mobile Support	✅ React Native + Expo
Code Generation	✅ CLI commands
Support	Email + Discord community
Updates	✅ Lifetime updates
Price	$149$29950% OFF One-time payment • Limited to 1,000 customers

🔥 Launch Offer - $149 (50% off)

Get all 6 templates + 16 AI Skills + 10 MCP servers. Limited to first 1,000 customers.

Get Craft — $149→

✅ 30-day money-back guarantee • ✅ Lifetime updates

AI Development: Two Modes

🧪 Automatic Mode (EXPERIMENTAL)

BETA

With /auto-feature, Claude attempts to execute all phases automatically with minimal intervention. This is experimental multi-agent orchestration.

⚠️ Experimental Feature

Based on advanced prompt engineering, not guaranteed 100% automatic
Claude may still ask for confirmation at certain steps
Success rate varies based on task complexity
For guaranteed control, use Manual Mode below

Task: "Add product catalog with filtering"

1️⃣ You invoke automatic mode

You: "/auto-feature Add product catalog with filtering and pagination"

Then Claude runs EVERYTHING automatically ↓

🎯 Phase 1: Auto-detect level

Detected: Balanced level, Web platform

🏗️ Phase 2: Architect designs

• 3-layer architecture (Router → Service → Repository)

• ADR created for pagination strategy

👨‍💻 Phase 3: Developer implements

• Created 3 files (router, service, repository)

• All rules validated automatically

🧪 Phase 4: Tester writes & runs tests

• 13 tests generated and passing

• 73% coverage (target: 70%)

✅ Phase 5: Reviewer validates

• Code quality: ✅ Passed

• Architecture: ✅ No violations

• Tests: ✅ 13/13 passing

🎯 Expected Result (When Working Optimally)

• 3 files created (router, service, repository)

• 13 tests written and passing

• 73% coverage achieved

• All checks passed automatically

• Time: ~12-20 minutes with minimal intervention

💡 How It Works

Advanced prompting - Instructions tell Claude to minimize confirmations
Real multi-agent orchestration - Architect → Developer → Tester → Reviewer
Auto-detection - Reads .craftrc.json to apply correct rules
Auto-validation - MCP tools check quality automatically
Variable automation - May ask for clarification on complex decisions

Manual Mode (Interactive)

YOU APPROVE EACH STEP

With paid tier, you get 4 AI agents and skills that guide development. Here's how it works in practice:

Task: "Add subscription management page"

1️⃣ You invoke the workflow skill

You: "/feature Add subscription management with upgrade/downgrade"

2️⃣ Architect agent analyzes (if Balanced/Crafted)

• Reads your project's level from .craftrc.json

• Suggests 3-layer architecture (Router → Service → Repository)

• You review and approve the plan

3️⃣ Developer agent implements

• Generates tRPC router (max 20 lines)

• Creates service layer with business logic (max 50 lines)

• Creates repository for data access

• You review the generated code

4️⃣ Tester agent creates tests

• Generates unit tests for service layer

• Creates integration tests for router

• Runs tests and shows results

5️⃣ MCP tools validate automatically

• rules-validator: Checks function length, params, duplication

• architecture-guard: Verifies layer boundaries

• If violations found, developer agent refactors

6️⃣ Reviewer agent does final check (optional)

• You invoke: /reviewer

• Reviews code quality, test coverage, security

• Suggests improvements if needed

✅ Result:

• 3 files created (router, service, repository)

• 8+ tests written and passing

• 70%+ test coverage achieved

• All quality rules validated

• Time: 10-15 minutes with your guidance

💡 Important to Know:

Agents guide and accelerate development, but you stay in control
You review and approve code at each step
The workflow is interactive, not fully automatic
Quality is maintained through MCP validation tools
This is AI-assisted development, not AI-automated development

Community Tier: Manual Development with Basic Assistance

Community tier provides 2 agents (developer, tester) without workflow skills. You manually coordinate:

1. You write code or ask developer agent for help

2. You manually invoke tester agent for test generation

3. You run craft generate for boilerplate

4. Still powerful, but requires more manual coordination

Complete Setup Workflow

# 1. Install CLI

npm install -g @getcraft-dev/craft-cli

# 2. Login

craft login craft_your_api_key_here

# 3. Activate Craft license (optional)

craft license activate

# 4. Create project

craft new

# Select: Balanced - Web + Mobile

# 5. Setup project

cd my-saas-app

pnpm install

cp .env.example .env.local

# Edit .env.local with your keys

# 6. Setup AI tooling

craft setup ai

# 7. Run migrations

pnpm --filter @craft/database db:generate

# 8. Start development

pnpm dev

# 9. Generate code

craft generate router products

craft generate page /dashboard

Getting Help

`craft help`

Display help message with all available commands

`craft --version`

Show CLI version

Configuration Files

User Configuration

~/.craft/config.json- API key storage

~/.craft/license.json- License information

Project Configuration

.craftrc.json- Project config (level, platform)

.mcp.json- MCP servers configuration

.claude/- AI agents and skills

.ai/- MCP servers and context manager

Support

Documentation

Full documentation and guides

Browse docs →

Discord Community

Get help from the community

Join Discord →

GitHub Issues

Report bugs and request features

Open issue →

Email Support

Direct support (paid tier)

contact@getcraft.dev →