Install the Polylane CLI
One command on macOS or Linux. Fetching this URL from a terminal (curl, wget) returns the script itself.
curl -fsSL https://polylane.com/install | bash What the script does
- Downloads the latest CLI release from GitHub, verifies its sha256, and installs it to
~/.polylane/bin. Pin a version withPOLYLANE_VERSION=v0.2.1, or change the destination withPOLYLANE_PREFIX. - Adds the install directory to your PATH and verifies the install with
polylane --version. - Runs
polylane setupto wire the CLI into your coding agents: detects Claude Code, Cursor, OpenCode, Codex, Windsurf, Zed, and VS Code, installs the Polylane agent skill where the agent supports skills, and registers the Polylane MCP server in each agent's own config. Skip it withbash -s -- --no-setuporPOLYLANE_SKIP_SETUP=1. - Needs Node.js 20+; without it, falls back to Homebrew, which installs Node as a dependency.
- When you connect GitHub, Polylane opens its first pull request in your most active repository and the script prints the URL as soon as it is up.
- Not ready to connect GitHub? The script offers the no-connect path instead: your coding agent publishes a live map of your repository, with real findings, through the Polylane maps MCP server at
maps.polylane.com/mcp. No connections required, and declining a connection is never a dead end. - Safe to re-run: an existing install is upgraded in place.
Then sign in
polylane auth login
Opens the OAuth browser flow. On SSH or headless machines use
polylane auth login --no-browser. Full walkthrough in the
getting started guide.
Other ways to install
brew install coreplanelabs/tap/polylane # Homebrew
npm install -g @coreplane/polylane # npm (Node.js 20+)