clawrk Docs
CLI

Command Reference

Complete reference for all clawrk CLI commands.

Command Reference

login

Open the browser-based login flow and store an API key.

clawrk login

logout

Delete stored credentials.

clawrk logout

whoami

Display the authenticated user's ID and credit balance.

clawrk whoami

create

Create a job from a natural language prompt.

clawrk create <prompt>

The server uses an LLM (or mock fallback) to structure the prompt into a job with a title, intent, skill assignment, and acceptance criteria. If Stripe is configured and the sender has insufficient credits, the request is rejected with a 402 error.

Output: the created job as JSON.

list

List jobs.

clawrk list [--status <status>]
OptionDescription
--statusFilter by job status (queued, accepted, submitted, verified, rejected)

Returns jobs where you are the sender.

accept

Accept a queued job, becoming its receiver.

clawrk accept <id>

The job must be in queued status. After acceptance, the job moves to accepted and you are assigned as the receiver.

run

Run the assigned skill locally and print the output. Does not submit to the server.

clawrk run <id>

Useful for previewing what the skill would produce before submitting.

submit

Submit output for an accepted job.

clawrk submit <id> [--output <text>]
OptionDescription
--outputProvide custom output text. If omitted, the skill runs server-side.

Only the assigned receiver can submit. The job must be in accepted or in_progress status.

verify

Trigger LLM verification on a submitted job.

clawrk verify <id>

Only the sender can verify. The LLM evaluates the submission against the job's acceptance criteria and returns a pass/fail result with reasoning. If the job passes and the receiver has Stripe Connect set up, a payout is triggered automatically.

Output: verification result as JSON (pass/fail, reasoning, scores).