Core
polpo init
Initialize Polpo in the current directory. Creates .polpo/polpo.json.
polpo start
Start the HTTP API server and web dashboard.
polpo run
Execute pending tasks without starting the server.
polpo status
Show current task status in the terminal.
polpo setup
Interactive setup wizard — configure auth, model, and first agent.
Tasks
polpo task add <description>
Create a new task.
polpo task list
List all tasks with status.
polpo task show <taskId>
Show task details.
polpo task retry <taskId>
Retry a failed task.
polpo task kill <taskId>
Kill a running task.
polpo task reassess <taskId>
Re-run assessment on a completed task.
polpo task delete <taskId>
Delete a task.
Missions
polpo mission create <prompt>
Generate a new mission from a natural language prompt using the LLM.
polpo mission list
List all missions.
polpo mission show <missionId>
Show mission details.
polpo mission execute <missionId>
Execute a saved mission.
polpo mission resume <missionId>
Resume a mission — retries failed tasks.
polpo mission abort <group>
Abort all tasks in a mission group.
polpo mission delete <missionId>
Delete a mission.
Agents
polpo team list
List all agents and teams.
polpo team add <name>
Add a new agent to the team.
polpo team remove <name>
Remove an agent from the team.
polpo team rename <newName>
Rename the team.
polpo agent
Agent identity and management commands.
Skills
polpo skills list
List all installed skills with agent assignments.
polpo skills add <source>
Install skills from a GitHub repo or local path.
polpo skills remove <name>
Remove a skill from the pool.
polpo skills assign <skill> <agent>
Assign a skill to an agent.
polpo skills tag <skill>
Set tags and/or category for a skill.
polpo skills orchestrator
Manage orchestrator-level skills.
Memory
polpo memory show
Display shared memory content.
polpo memory set <content>
Replace memory with the given content.
polpo memory append <line>
Append a line to memory.
polpo memory edit
Open memory in $EDITOR.
Chat
polpo chat <message>
Chat with an agent.
Configuration
polpo config show
Display current configuration.
polpo config validate
Validate .polpo/polpo.json.
Models
polpo models list
List available LLM models and providers.
Schedules
polpo schedule list
List scheduled mission executions.
polpo schedule create
Create a new schedule.
Logs
polpo logs
View persistent event logs.
Playbooks
polpo playbook list
List available playbooks.
polpo playbook run <name>
Execute a playbook.
Auth
polpo auth
Manage OAuth authentication for LLM providers.
Other
polpo update
Update Polpo to the latest version.
polpo ink
Manage the Ink registry — install community playbooks, agents, and configurations.
Cloud
polpo login
Authenticate with Polpo. Opens browser or accepts --api-key.
polpo logout
Clear stored credentials.
polpo deploy
Deploy the local .polpo/ project to the cloud. Detects LLM keys and offers to push them.