CLI overview
The polylane command line interface lets you use every part of Polylane from your terminal, your scripts, and your coding agents. It is built agent-first: output is a text table in a terminal and JSON when piped, non-interactive flags exist everywhere, and the full API surface is available as an escape hatch.
Install
All channels install the same Node-based bundle and require Node.js 20 or later. Homebrew pulls Node.js in as a dependency; the curl and PowerShell installers check for it.
npm install -g @coreplane/polylane
brew install coreplanelabs/tap/polylane
curl -fsSL https://polylane.com/install.sh | bash
irm https://polylane.com/install.ps1 | iex
Sign in
polylane auth login # browser OAuth
polylane auth login --no-browser # device code (SSH, headless)
polylane auth login --api-key sk_xxxxx # API key (scripts, agents)
polylane auth signup --email you@example.com # bootstrap a fresh account
More options live in Authentication.
Install the skill for your coding agent
The Polylane skills teach your coding agent when to reach for polylane, how to investigate production, and how to author automations.
npx skills add coreplanelabs/skills
Restart your coding agent so it picks up the new skill, then ask it things like "use polylane to investigate this issue".
Command groups
Commands are grouped by resource:
| Group | What it covers |
|---|---|
issue | Detected issues, their timelines, notes, and milestones |
service | Cloud infrastructure: nodes, logs, metrics, dependency graph |
repo | Repositories and code search |
tools | Run Polylane agent tools directly (tools search, tools run, tools code) |
memory | Persistent agent memory |
note | Daily and global workspace notes |
thread | Conversation threads (thread ask, thread continue, streaming supported) |
artifact | Per-thread artifacts: reports, diagrams, pull requests |
skill | Agent skills: catalog, list, show, docs |
automation | Automations and their executions |
autofix | Automated code fixes (read-only) |
integration | Observability tools and code hosts |
cloud | Cloud accounts (aws, cloudflare, fly, render, vercel) |
workspace | Create and switch workspaces |
auth | Login, status, logout |
config | CLI configuration |
telemetry | Anonymous usage telemetry: status, enable, disable |
api | Raw API access |
update | Check for CLI updates |
Discover commands
--help is the authoritative reference. It always matches the version you have installed.
polylane --help # top-level commands
polylane <resource> --help # commands for a resource
polylane <resource> <command> --help # flags and examples
Anything not yet a first-class command is available under polylane api:
polylane api list --tag Issues
polylane api describe <operation-id>
polylane api call <operation-id> --body '{...}'
See the API reference for the full list of operations.
Where to next
- Authentication: every credential path and where credentials are stored.
- Scripting: non-interactive flags for agents and continuous integration.
- Configuration: environment variables and the config file.