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 dev              # Start with hot reload (tsx watch)
skimpyclaw status           # Show service + gateway status
skimpyclaw logs --file stdout --lines 200 --follow

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

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)