Getting Started with Code CLI

Installation

Install Code CLI with a single command:

bash
curl -fsSL https://poly.inc/install.sh | bash

This works on macOS, Linux, and WSL. The installer detects your platform and installs the appropriate binary.

Configuration

After installation, authenticate with your Poly account:

bash
poly auth login

Code CLI will open a browser window for authentication. Once authenticated, your API keys are securely stored in your system keychain.

Your First Session

Navigate to any project directory and start a session:

bash
cd my-project
poly chat

Code CLI will analyze your project structure and be ready to help. Try asking it to:

• Explain a function or module
• Fix a bug you've been stuck on
• Write tests for existing code
• Refactor a messy file

Autonomous Mode

For longer tasks, use autonomous mode:

bash
poly auto "Add user authentication with JWT"

Code CLI will plan the implementation, create the files, write tests, and iterate until the task is complete. You can review and approve changes along the way.

Remote Access

Start a session and access it remotely through Poly Chat:

bash
poly chat --remote

This generates a session link you can open on any device — including your phone. Review progress, approve actions, and steer the agent from anywhere.

Next Steps

• Read the full documentation
• Join the community Discord
• Explore example workflows