The polpo deploy command syncs your local .polpo/ directory to Polpo. It uploads agent configurations, missions, playbooks, and optionally your task and session data.
Prerequisites
Log in before deploying:
This stores your credentials locally for subsequent commands.
Usage
Options
| Flag | Description |
|---|
--dir <path> | Path to .polpo/ directory (defaults to .polpo) |
--yes | Skip confirmation prompt |
--include-tasks | Include task definitions |
--include-runs | Include run history |
--include-sessions | Include session data |
--all | Include tasks, runs, and sessions |
What gets deployed
Always included:
| Resource | Source |
|---|
| Agents | .polpo/agents.json |
| Teams | .polpo/teams.json |
| Memory | .polpo/memory/ |
| Missions | .polpo/missions/ |
| Playbooks | .polpo/playbooks/ |
| LLM keys | Detected from environment |
| Resource | Flag |
|---|
| Tasks | --include-tasks |
| Run history | --include-runs |
| Sessions | --include-sessions |
| Everything | --all |
Deploy flow
Load credentials
The CLI reads your stored auth token from polpo login.
Scan .polpo/
All files in the .polpo/ directory are scanned and categorized.
Display summary
A summary of what will be deployed is printed for review.
Confirm
You’re prompted to confirm (skip with --yes).
Deploy
Files are uploaded to the Polpo API.
Report
A deployment report is printed with success/failure status for each resource.
Example
$ polpo deploy --include-tasks
Polpo Deploy
──────────────────
Project: my-project
Directory: .polpo/
Resources found:
Teams ........... 2
Agents .......... 5
Missions ........ 3
Playbooks ....... 1
Memory files .... 4
Tasks ........... 12
Detected LLM keys:
ANTHROPIC_API_KEY → sk-ant-...xxxx
XAI_API_KEY → xai-...xxxx
Push LLM keys to cloud? (y/N) y
Deploy these resources? (y/N) y
Deploying...
✓ LLM Keys 2/2
✓ Teams 2/2
✓ Agents 5/5
✓ Missions 3/3
✓ Playbooks 1/1
✓ Memory 4/4
✓ Tasks 12/12
Deploy complete. 29 resources synced.
Deploying overwrites the remote state for all included resource types. It does not merge — the remote configuration is replaced with your local .polpo/ contents.
