@parsemend/cli

The Parsemend CLI runner (§4.8 of the platform design spec): pulls a fix context bundle for an issue from your Parsemend instance and runs the same root-cause → solution → coding pipeline locally, against your own working copy, using your own model keys (or a local claude CLI handoff). Source code is never uploaded to Parsemend's servers — only the opt-in post-back sends root-cause/diff data back, never files.

Install

npm install -g @parsemend/cli
# or, from this repo:
npm install && npm run build && npm link

Requires Node 20+.

Usage

parsemend login                # store your personal API token
parsemend fix <issue-url|id>   # run the pipeline
parsemend post-back <issue-id> # publish a prior local run's results
parsemend logout
parsemend upgrade              # update to the latest published version
parsemend --version

qa commands (CI-facing)

parsemend qa run and parsemend qa export are the qa-C CI/PR-gating surface: they authenticate with a durable org token (PARSEMEND_ORG_TOKEN env var, checked first, else --token) rather than the personal login token, since CI doesn't run an interactive login.

parsemend qa run --suite <name> --org <slug> --project <slug> [--base-url <url>] [--environment <name>] [--wait] [--json]
parsemend qa export --org <slug> --project <slug> [--out <file>]

qa run triggers a suite run; with --wait it polls until the run reaches a terminal status (passed/failed/errored) and exits 0 iff passed — raw pass/fail only, never gated by per-flow triage verdicts. --sha, --branch, --pr-number, and --repository pass GitHub context through for the server's check-run/Issue-link reporting. qa export lists a project's flow definitions as YAML.

See docs/ci-example.md for a full GitHub Actions example that blocks a job on qa run --wait's exit code.

Security note

parsemend login writes ~/.parsemend/config.json, containing your personal API token in plaintext and, if you configure them, your own provider API keys. The file is written 0600 (and its directory 0700), which restricts it on POSIX systems (macOS/Linux). This offers no protection on Windows — that platform is out of scope for this version.

Configuration

The CLI talks to https://api.parsemend.com by default, so login only really needs your token — press enter at the base-URL prompt. Set PARSEMEND_API_URL (or answer that prompt) to point at a self-hosted or staging deployment; the environment variable wins over the saved config.

Model roles (explore/conclude/format/code) resolve from, in order: a CLI flag, a PARSEMEND_MODEL_<ROLE> environment variable (e.g. PARSEMEND_MODEL_EXPLORE=anthropic:claude-haiku-4-5), or a built-in default. Supported providers: anthropic, openai, google, ollama (served via an OpenAI-compatible local endpoint).

Tests

npm test

License

MIT — see LICENSE.