Crafters CLI

Crafters CLI

Install: npx skills add crafter-station/cs -g

Agent-first CLI for managing Crafter Station infrastructure: domains, DNS, Vercel projects, Kai agents, and Claude Code configuration.

Prerequisites

Check setup: crafters whoami --json. If it fails:

1. Install: bun add -g crafter-station/cs
2. Login: crafters login --spaceshipKey=X --spaceshipSecret=X --vercelToken=X --domains=crafter.run,crafter.ing
3. Sync skills: crafters claude install

Discovery

Introspect all available commands and their arguments:

crafters schema --json
crafters schema domain.add --json

Domain Management

Add a subdomain (Vercel + DNS)

crafters domain add <subdomain> -p <vercel-project> --domain <base-domain> --json

Example:

crafters domain add legalize-pe -p legalize-pe-web --domain crafter.ing --json

Preview before executing

crafters domain add <subdomain> -p <project> --domain crafter.ing --dry-run --json

List all subdomains

crafters domain list --domain crafter.run --json
crafters domain list --domain crafter.ing --json

Remove a subdomain

crafters domain remove <subdomain> -p <project> --domain crafter.run --json

DNS-only (no Vercel)

crafters domain add <subdomain> -t <cname-target> --domain crafter.ing --json

With Clerk secondary domain

crafters domain add <subdomain> -p <project> --clerk-key sk_live_xxx --domain crafter.run --json

Agent Management

crafters agent list --json
crafters agent info <name> --json
crafters agent status --json
crafters agent doctor --json
crafters agent doctor --fix --json

Configuration

crafters whoami --json
crafters login --spaceshipKey=X --spaceshipSecret=X --vercelToken=X --baseDomain=crafter.run --domains=crafter.run,crafter.ing

MCP Server

Start as an MCP server over stdio:

crafters mcp

Rules for AI Agents

1. ALWAYS use --json flag for structured output
2. ALWAYS use --dry-run before mutating operations, then confirm with the user
3. ALWAYS specify --domain when working with crafter.ing (default is crafter.run)
4. Subdomain must be lowercase alphanumeric with hyphens only
5. The CLI automatically uses the Vercel-recommended project-specific CNAME (not the generic cname.vercel-dns.com)
6. SSL certificates are issued automatically by Vercel after DNS propagation

Available Domains

Output Format

All --json responses follow:

{"ok": true, "data": {...}}
{"ok": false, "error": {"code": "ERROR_CODE", "message": "..."}}

Error Codes