Commands + Scripts

After npm install -g clawmagic, the clawmagic command is available globally. If running from the repo directly, replace clawmagic with node clawmagic.mjs.

# Agent interaction
clawmagic agent "Your prompt here"    # Run a single prompt
clawmagic agent                        # Start interactive chat

# Setup and diagnostics
clawmagic onboard                      # Interactive setup wizard
clawmagic doctor                       # Health checks with auto-fix
clawmagic health                       # Quick health check
clawmagic security                     # Security posture audit
clawmagic status                       # Show current system status
clawmagic configure                    # Edit configuration interactively

# Service management (gateway)
clawmagic gateway run                  # Run gateway in foreground
clawmagic gateway install              # Install as background service (launchd/systemd)
clawmagic gateway start                # Start installed service
clawmagic gateway stop                 # Stop installed service
clawmagic gateway restart              # Restart after updates
clawmagic gateway status               # Check service status
clawmagic gateway uninstall            # Remove service

# Plugin and skill management
clawmagic plugins                      # Plugin operations
clawmagic skills                       # Skill management
clawmagic validate                     # Validate plugin packages

# Scheduling and automation
clawmagic cron                         # Cron job management

# Provider and model management
clawmagic models                       # List and manage AI models
clawmagic auth                         # OAuth flow management (Google, etc.)

# Monitoring
clawmagic logs                         # View server logs
clawmagic usage                        # Show usage statistics

# Utilities
clawmagic sync                         # Sync state and config
clawmagic mindsheet                    # Google Sheets brain management
clawmagic completions                  # Shell completion setup

npm install                     # Install dependencies
npm run build                   # Build all packages (core, server, CLI, web)
npm run build:quick             # Build all except web (faster inner-loop)
npm run build:web               # Build web portal only
npm run build -w @clawmagic/core    # Build core package only
npm run build -w @clawmagic/server  # Build server only

npm run dev                     # Start server + portal in dev mode
npm run dev:server              # Server only (dev mode)
npm run dev:web                 # Portal UI only (Vite dev server)

npm run start                   # Start server + portal (production build)
npm run start:server            # Server only (production)
npm run start:web               # Portal only (builds first, then serves)

npm run clean                   # Remove build artifacts
npm run gateway                 # Shortcut: node apps/cli/dist/main.js gateway

# Fastest: npm global install (pre-built, no build step)
npm install -g clawmagic
clawmagic onboard

# Full installer (auto-installs Node.js if missing)
bash scripts/install.sh

# CLI-only install (skip web portal build, ~2 min faster)
bash scripts/install.sh --quick
# or
npm run install:cli

# Pre-built channel (no build step, for hosting providers)
bash scripts/install.sh --prebuilt

# Docker
docker pull ghcr.io/clawmagic/clawmagic:latest
docker compose up -d

# Core test suite (safety invariants + boundary checks + plugin compat)
npm run test

# Individual checks
npm run check                   # Boundary checker + syntax validation
node tools/test-safety-invariants.mjs   # Core safety checks
node tools/check-boundary.js           # Import boundary validation

# TypeScript
npm run typecheck:server:guardrails    # Server type checking

# ActionSpec
npm run test:spec-packeting     # ActionSpec test suite
npm run spec:scaffold -- --plugin <plugin_id>  # Generate ActionSpec templates

# Plugin test suites
npm run check:plugin-security          # Plugin security audit
npm run test:plugins:conformance       # Plugin conformance tests
npm run test:plugins:trust-checks      # Trust chain verification
npm run test:plugins:signature-policy  # Signature enforcement

# Marketplace tests
npm run test:marketplace:signatures    # Marketplace signature verification
npm run test:marketplace:malicious-scan  # Malware scan tests

# Heartbeat and runtime
npm run test:heartbeat:integration     # Heartbeat integration tests
npm run benchmark:runtime              # Runtime performance benchmarks

# Plugin management via CLI
clawmagic plugins                      # List and manage plugins
clawmagic validate                     # Validate a plugin package

# Plugin management via agent chat
clawmagic agent "List installed plugins"
clawmagic agent "Install the hello-world plugin"
clawmagic agent "Disable the slack-connector plugin"

# Scaffold ActionSpec for a plugin
npm run spec:scaffold -- --plugin hello-world

# Plugin security checks
npm run check:plugin-security

# Browse marketplace plugins
curl https://api.clawmagic.ai/v1/plugins

# Authenticate (magic link)
curl -X POST https://api.clawmagic.ai/v1/auth/start \
  -H 'content-type: application/json' \
  -d '{"email":"you@example.com","clientAppId":"clawmagic-local"}'

# Request plugin delivery
curl -X POST https://api.clawmagic.ai/v1/agent/deliveries/request \
  -H "Authorization: Bearer cmk_xxx" \
  -H 'content-type: application/json' \
  -d '{"entitlementId":"ent_123"}'

# Report install result
curl -X POST https://api.clawmagic.ai/v1/agent/install-report \
  -H "Authorization: Bearer cmk_xxx" \
  -H 'content-type: application/json' \
  -d '{"entitlementId":"ent_123","status":"SUCCESS"}'

# Check wallet balance
curl https://api.clawmagic.ai/v1/me/wallet \
  -H "Authorization: Bearer mpk_xxx"

# View affiliate dashboard
curl https://api.clawmagic.ai/v1/me/affiliate-dashboard \
  -H "Authorization: Bearer mpk_xxx"

The wallet is part of the Agent-First economy — buy, sell, and promote tools to earn money. Sellers earn from sales, affiliates earn from referrals, and wallet balance can be used for purchases. Payouts are processed outside the system for security and tax compliance.