@conductor-cli/cli
v0.1.1
Published
Conductor CLI — orchestrate Claude Code across your codebase.
Maintainers
Readme
@conductor-cli/cli
The open-source CLI for Conductor — an orchestration backend that turns specs into tasks and runs Claude Code against them, so you don't have to babysit an agent one prompt at a time.
your project ──▶ conductor run ──▶ Conductor API ──▶ pulls next spec
│ │
▼ ▼
runs Claude Code tracks status/logs/cost
│ (dashboard @ conductor.software)
▼
opens a PR / reports outcomeThis repository is the client: it talks to the Conductor API over HTTPS using your project's API key. It has no dependency on Conductor's internal infrastructure — anyone can read it, fork it, or build an alternative client against the same API contract. The hosted dashboard, team features, and billing live in Conductor Cloud (closed source, conductor.software).
Install
npm i -D @conductor-cli/cliQuick start
npx conductor init # wizard: project_id + api_key
export CONDUCTOR_API_KEY=cnd_...
npx conductor run # execute next pending specCommands
| Command | Purpose |
| ---------------------------------- | ----------------------------------------------------------------------- |
| conductor init | Wizard. Writes conductor.config.json, stores API key in OS keychain. |
| conductor run [--all] [--watch] | Run the orchestrator against pending specs. |
| conductor status | Project info + latest specs. |
| conductor register --path <p> | Register a project with the local conductord daemon. |
| conductor upgrade | npm update @conductor-cli/cli in the current project. |
| conductor version | Print CLI version. |
conductor run uses the bundled orchestrator engine by default. If your
project ships its own ./scripts/orchestrator.mjs, that's used instead — this
keeps existing Conductor projects working unchanged.
Environment variables
| Var | Default | Notes |
| ------------------------ | ----------------------------- | ------------------------------------- |
| CONDUCTOR_API_KEY | — | Required. |
| CONDUCTOR_URL | https://conductor.software | API endpoint. |
| CONDUCTOR_MASTER_PASS | (machine-specific) | Encrypts the keychain fallback file. |
| CONDUCTORD_URL | http://127.0.0.1:7731 | Used by conductor register. |
Cross-platform key storage
- macOS: Keychain via
security. - Linux:
secret-tool(libsecret). - Fallback (any OS): AES-256-GCM encrypted
~/.conductor/keys.enc.
Contributing
See CONTRIBUTING.md. Bug reports and PRs welcome — this package has zero dependency on Conductor's private infrastructure, so you can develop and test it fully offline against a mocked API.
Security
See SECURITY.md for how to report vulnerabilities.
License
MIT — see LICENSE.
