Documentation menu
CLI

CLI reference

Install the skaftor CLI and drive your work orders from the terminal — the same MCP surface coding agents connect to.

The skaftor CLI is a thin, zero-dependency client over the platform's per-project MCP server. It authenticates with your personal dev-link token, so it sees exactly what you're assigned and can move work orders, open pull requests, and pull execution context without leaving the shell.

Install

curl -fsSL https://app.skaftor.com/install | sh   # needs Node.js 18+

That drops the skaftor command into ~/.local/bin (override with SKAFTOR_BIN). Add it to your PATH if needed.

Connect

skaftor login "https://app.skaftor.com/api/mcp/<projectId>?dev=<token>"
skaftor context          # list connections, ● marks the active one
skaftor use "Payments Core"
skaftor whoami

Work orders

skaftor wo next                 # the recommended next task for you
skaftor wo mine                 # everything assigned to you
skaftor wo list --status ready  # filter by status or --phase
skaftor wo show   AUTH-02       # full spec + acceptance criteria
skaftor wo plan   AUTH-02       # decision engine: repo, files, reuse, impact
skaftor wo manifest AUTH-02     # the full execution manifest as JSON

skaftor wo start  AUTH-02 --branch feature/auth-2
skaftor wo ask    AUTH-02 "Should partial reversals be idempotent?"
skaftor wo done   AUTH-02 --pr https://github.com/acme/repo/pull/42 \
                  --summary "Implemented core path" --ide "Claude Code"
The connection is saved to ~/.skaftor/config.json (chmod 600 — it holds a token).

Related