Getting started
polpo create
Interactive wizard that handles authentication, project creation, scaffolding, and skill installation in one step.
polpo create [--name <name>] [--org-id <id>] [--template <name>] [--skills global|project|skip] [--install-cli] [-y, --yes]
| Flag | Description |
|---|
--name <name> | Project name (skips prompt) |
--org-id <id> | Target organization |
--template <name> | Scaffold template |
--skills <scope> | Install coding agent skills: global, project, or skip |
--install-cli | Install CLI globally after scaffold |
-y, --yes | Accept all defaults |
polpo link
Link the current directory to an existing cloud project.
polpo link --project-id <uuid> [-d, --dir <path>]
| Flag | Description |
|---|
--project-id <uuid> | Project ID (required) |
-d, --dir <path> | Working directory |
polpo install
Authenticate and install coding agent skills (Cursor, Claude Code, Codex, etc.).
polpo install [--client <list>] [--scope global|project] [-d, --dir <path>] [-i, --interactive]
| Flag | Description |
|---|
--client <list> | Comma-separated agent IDs (e.g. claude-code,cursor) |
--scope <mode> | global (default) or project |
-d, --dir <path> | Working directory for project scope |
-i, --interactive | Enable interactive prompts |
claude-code, cursor, codex, copilot, windsurf, cline, trae, roo-code, qoder, opencode.
Authentication
polpo login
Authenticate with Polpo via device-code flow (opens browser) or API key.
polpo login [--api-key <key>] [--url <base-url>] [--dashboard-url <url>] [--no-browser]
| Flag | Description |
|---|
--api-key <key> | Authenticate with an API key (skips browser flow) |
--url <url> | Custom API base URL |
--dashboard-url <url> | Custom dashboard URL |
--no-browser | Don’t auto-open the browser |
polpo logout
Clear stored credentials.
polpo whoami
Show the authenticated user and default organization.
Deployment
polpo deploy
Deploy the local .polpo/ directory to the cloud. Uploads agents, teams, skills, memory, missions, playbooks, schedules, vault credentials, and avatars. Detects local LLM provider keys and offers to push them.
polpo deploy [-d, --dir <path>] [-y, --yes] [-f, --force] [--include-tasks] [--include-sessions] [--all]
| Flag | Description |
|---|
-d, --dir <path> | Path to .polpo/ directory |
-y, --yes | Skip confirmation prompt |
-f, --force | Force override without asking |
--include-tasks | Include task definitions |
--include-sessions | Include session data |
--all | Include tasks, sessions, and runs |
Resources (agents, teams, skills, memory, missions, playbooks) are defined in .polpo/ files and synced to the cloud via polpo deploy. Edit the files locally and deploy.
LLM Keys (BYOK)
polpo byok set <provider>
Set a provider API key for direct provider access (bypassing the gateway).
polpo byok set <provider> [--key <key>] [--label <label>] [--project <project-id>]
polpo byok list
List configured provider keys (masked).
polpo byok list [--project <project-id>]
polpo byok remove <provider>
Remove a provider key.
polpo byok remove <provider>
Projects & Organizations
polpo projects list
List all projects in an organization.
polpo projects list [--org <org-id>]
polpo projects create <name>
Create a new project.
polpo projects create <name> [--org <org-id>]
polpo orgs list
List organizations.
Monitoring
polpo cloud-status
Show cloud project status.
polpo cloud-status [-d, --dir <path>]
polpo cloud-logs
View cloud execution logs.
polpo cloud-logs [--follow] [-d, --dir <path>]
Utility
polpo models list
List available LLM models and providers.
polpo models list [--provider <name>] [--json] [--plain]
polpo update
Update Polpo CLI to the latest version.
