CrowCode CLI (crow)

The Orchestree platform in your terminal: sign in, inspect your identity, manage model gateways, and launch the suite's agents.

The product is CrowCode. The command you type is crow — the same pattern as git/GitHub: short where fingers live, full name where brands live.

Installation

npm install -g @orchestree/cli

This installs the crow command. orchestree is also installed as a working alias (kept for one major version) — it runs the exact same CLI and prints a one-line tip to stderr.

Requires Node.js >= 20.

Usage

crow login [--stdin] [--api <base>]   # sign in with an Orchestree API key
crow logout                           # sign out — clears every credential backend
crow whoami                           # show org · key name · scope
crow gateways                         # list model gateways and their status
crow gateways setup <id>              # configure a gateway (e.g. vertex)
crow crowcode [args...]               # launch the CrowCode coding agent
crow --version | --help

Authentication notes

• Keys are stored in the OS keychain (0600 file fallback with a warning).
• ORCHESTREE_API_KEY overrides stored credentials — CI only; any agent subprocess this CLI spawns can read the environment.
• The key is never accepted as a command-line argument. Use the hidden prompt (crow login) or pipe it: crow login --stdin < keyfile.

Why is the command called crow?

CrowCode is the product name; crow is what you type. Long commands don't survive contact with a terminal — git isn't github, kubectl users alias it to k. orchestree keeps working as an alias for one major version so existing scripts never break.

Development

From the monorepo root:

pnpm --filter @orchestree/cli... build   # build this package and its deps
pnpm --filter @orchestree/cli test:run   # run tests

See CHANGELOG.md for release history.