CLI Reference

After install, skimpyclaw is available globally. During development use pnpm run cli -- <command>.

Service management

skimpyclaw onboard          # Interactive setup wizard
skimpyclaw start            # Start in foreground
skimpyclaw start --daemon   # Start macOS launchd daemon
skimpyclaw stop             # Stop macOS launchd daemon
skimpyclaw restart          # Restart macOS launchd daemon
skimpyclaw status           # Show service + gateway status
skimpyclaw logs --file stdout --lines 200 --follow
skimpyclaw uninstall        # Remove launch agent, keep ~/.skimpyclaw data
skimpyclaw uninstall --purge # Remove launch agent and ~/.skimpyclaw data

For local development with hot reload, use pnpm dev.

Config

skimpyclaw config get gateway.port
skimpyclaw config set gateway.port 18790

Model

skimpyclaw model <alias|provider/model|model-id>
skimpyclaw model smart
skimpyclaw model anthropic/claude-sonnet-4-5
skimpyclaw model claude-sonnet-4-5

Messaging

skimpyclaw send "plan my day"

Cron

skimpyclaw cron list
skimpyclaw cron run morning

Tools

skimpyclaw tools list
skimpyclaw tools install my-server --command npx --args '["@some/mcp-server"]'
skimpyclaw tools install my-server --url http://localhost:3001/sse
skimpyclaw tools remove my-server

Browser

skimpyclaw browser open https://example.com
skimpyclaw browser open https://example.com --browser firefox
skimpyclaw browser open https://example.com --headful --slowmo 50
skimpyclaw browser waitFor "h1"
skimpyclaw browser getText
skimpyclaw browser getText "h1"
skimpyclaw browser evaluate --script "document.title"
skimpyclaw browser scroll
skimpyclaw browser scroll --direction up
skimpyclaw browser scroll --amount 500
skimpyclaw browser scroll ".target"
skimpyclaw browser select "#dropdown" "value"
skimpyclaw browser hover ".menu-item"
skimpyclaw browser screenshot
skimpyclaw browser wait --ms 30000
skimpyclaw browser close

Sandbox

skimpyclaw sandbox status                  # Show active sandbox containers
skimpyclaw sandbox prune                   # Force-prune all sandbox containers
skimpyclaw sandbox init                    # Auto-setup runtime, image, and config
skimpyclaw sandbox init --profile dev      # Build with dev profile (more tools)
skimpyclaw sandbox init --runtime docker   # Use docker instead of container
skimpyclaw sandbox doctor                  # Sandbox-specific diagnostics and hints

npm scripts

pnpm run start        # run once
pnpm run dev          # run with watch mode
pnpm run build        # compile TypeScript to dist/
pnpm run typecheck    # type-check only
pnpm run test         # run Vitest
pnpm run ci           # full CI gate (lint + typecheck + test)