@kordra/cli
v0.1.31
Published
Kordra CLI — submit goals and run drones that auto-run dispatched tasks on your Claude subscription.
Maintainers
Readme
@kordra/cli
Kordra CLI — submit goals and run drones that auto-run the tasks you "Send to drones" in the Kordra console, on your own Claude subscription.
The version is PINNED below — a pinned tag means a future (or compromised) publish never auto-runs on your machine. Bump it deliberately.
Setup
npx @kordra/[email protected] login --token mx_... # your seat token (Kordra console → Settings → Connect your Claude seat)Run a drone
On any machine with claude logged in (it uses your Claude subscription, never an API key):
npx @kordra/[email protected] drone # start once; auto-claims + runs dispatched tasks
npx @kordra/[email protected] drone --quota 5 # optional spend cap
npx @kordra/[email protected] drone status # see the fleetRequires git and claude on PATH. Needs ~/.kordrarc.json (written by login) or KORDRA_HUB_URL + KORDRA_TOKEN in the env.
Harness mode (best-of-N + verification media)
Opt in with KORDRA_HARNESS=1 and a claimed task is run through the best-of-N harness
(triage → difficulty-rung generation → execution-based select → escalate) instead of a
single worker. It files a verification report the console shows on the REVIEW card:
the verdict, a per-candidate table, the winning diff, and a replay of the actual run.
KORDRA_HARNESS=1 kordra drone # run claimed tasks through best-of-NNothing auto-ships — the result still lands in REVIEW for a human. The harness only auto-verifies with a validated fail-then-pass test; otherwise it suggests + routes to you.
Record a UI walkthrough (T4)
Give the drone a capture spec and the harness records a real video of the new UI (the actual app, driven headlessly) plus a backend-change brief, both shown on the card:
KORDRA_HARNESS=1 \
KORDRA_CAPTURE_SERVE="<command to build+serve the app>" \
KORDRA_CAPTURE_URL="http://localhost:<port>" \
KORDRA_CAPTURE_STEPS='[{"caption":"open the new tab","click":"[data-tab=foo]","hold":2500}]' \
kordra droneA video (vs. a single screenshot) uses puppeteer-core (installed automatically as an
optional dep; drives your INSTALLED Chrome — no Chromium download) and ffmpeg on PATH.
Both degrade gracefully: no puppeteer-core → one still; no ffmpeg → a frame filmstrip.
The serve command must point the app at a seeded/mock backend — never production secrets.
