Polpo Cloud CLI
Install
npm install -g polpo-aiAuthentication
# Login via browser (recommended)
polpo login
# Verify
polpo cloud-status
# Logout
polpo logoutNon-interactive login
For CI/CD, scripts, or when browser login is not available, set the POLPO_API_KEY environment variable before running polpo login. Get your key from polpo.sh → API Keys.
export POLPO_API_KEY="..."
polpo loginDo not hardcode API keys in source code or commit them to version control.
Credentials stored at ~/.polpo/credentials.json.
Deploy Agents
Deploy syncs local .polpo/ config to the cloud project.
# From project root (must have .polpo/ directory)
polpo deployThis uploads:
- Agent configurations (from
polpo.jsonor.polpo/config.json) - Skills
- Memory
Creates the project automatically on first deploy if none is linked.
Managed AI Gateway
Polpo includes a managed AI gateway with free credits — no LLM key setup needed to get started. Your agents can use any supported model out of the box.
BYOK (Bring Your Own Key)
Optionally set your own LLM provider API keys per project. Keys are AES-256-GCM encrypted at rest.
# Set a key (interactive — prompts securely for the key value)
polpo byok set <provider>
# List keys (masked)
polpo byok list
# Delete a key
polpo byok delete <provider>Supported providers: openai, anthropic, xai, google, groq, openrouter, cerebras, mistral.
You can also set keys via the dashboard at polpo.sh → LLM Keys. Do not hardcode LLM keys in source code or commit them to version control.
Project Management
# List projects
polpo projects list
# Create a project
polpo projects create my-project
# View cloud project status
polpo cloud-statusStream Logs
# Stream real-time logs from the project
polpo cloud-logs [--follow] [--tail 50]Workflow: First Deploy
- Sign up at
polpo.sh - Create a workspace and project (onboarding handles this)
polpo login(opens browser for approval)- Create
.polpo/directory with agent config polpo deploy- Use
POST /v1/chat/completionswithagent: "name"to chat
No LLM keys needed — the managed gateway covers you with free credits.
Dashboard
Available at polpo.sh after signup:
- Overview: project stats
- Agents: view/manage agent configs
- Sessions: chat history with agents
- Skills: installed agent skills
- Memory: project + per-agent memory
- Webhooks: event notification endpoints
- API Keys: manage data plane keys
- LLM Keys: BYOK provider keys (optional)
- Settings: project configuration
API Base URL
- Cloud:
https://api.polpo.sh - Local development:
http://localhost:3890(defaultpolpo startport)
See references/cli-commands.md for the full CLI reference.