CLI reference

The skaftor CLI is a thin, zero-dependency client over your project's MCP server. It signs in with your personal developer token, so it sees exactly what you're assigned.

Install

npm install -g skaftor                         # latest release
# or
curl -fsSL https://app.skaftor.com/install | sh   # needs Node.js 18+

The install script puts the CLI in ~/.local/lib/skaftor and the skaftor command in ~/.local/bin. Override these with SKAFTOR_LIB and SKAFTOR_BIN. Add ~/.local/bin to your PATH if needed.

Connect

Copy your login line from a work order's Build sheet (the "CLI" row) or Settings › "Workstations" › "Log in":

skaftor login "https://app.skaftor.com/api/mcp/<projectId>?dev=<token>" [--name alias]
skaftor context            # list connections, ● marks the active one
skaftor use "Payments Core" # switch project
skaftor whoami
skaftor logout [--all]

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        # repo, files, reuse, impact
skaftor wo manifest AUTH-02        # the full execution manifest as JSON

skaftor wo start AUTH-02 --branch wo/auth-02
skaftor wo ask   AUTH-02 "Should partial reversals be idempotent?"
skaftor wo sync  AUTH-02 --commit <sha> --message "Add reversal path" --files a.ts,b.ts
skaftor wo done  AUTH-02 --pr https://github.com/acme/repo/pull/42 \
                 --summary "Implemented core path" --ide "Claude Code" [--model m] [--tokens n]

Delivery

skaftor pr  AUTH-02                # prepare / open the pull request
skaftor env --editor "Claude Code"  # register your working environment

Workstations

skaftor verify                     # preflight: plan, targets, connection
skaftor targets                    # where you can launch
skaftor up [name] [--on target] [--repo url] [--branch b] [--agent claude|codex|gemini|deepseek]
skaftor ws                         # list your workstations
skaftor ssh <name>
skaftor start <name>  |  skaftor stop <name>  |  skaftor rm <name> [--yes]

Advanced

skaftor tools                      # every tool the server exposes
skaftor call get_work_order --code AUTH-02
skaftor <command> --json           # machine-readable output