Managing Agents
Deploying an agent
- Click Deploy New Agent in the left sidebar
- Upload an agent pack (
.zip) or choose a previously uploaded pack - Set a name and model (overrides the pack’s
manifest.jsondefaults) - Click Deploy
The agent container is created and started. It appears on the Fleet Dashboard within a few seconds.
Start / Stop / Delete
From the Fleet Dashboard, each agent card has quick action buttons:
- Start — start a stopped agent
- Stop — stop a running agent (workspace is preserved)
- Delete — stop and remove the agent container. You’ll be asked whether to also delete the workspace.
Editing agent files
In the workspace view, the Files tab shows the agent’s workspace directory. You can:
- Browse and open files
- Edit files directly in the browser (code editor with syntax highlighting)
- Upload new files
- Delete files
Key files editable from the UI:
| File | Purpose |
|---|---|
SOUL.md | Agent identity and personality |
STYLE.md | Communication style |
MEMORY.md | Long-term memory |
HEARTBEAT.md | Periodic task checklist |
cron.json | Scheduled jobs |
Changes to SOUL.md, STYLE.md, and other identity files take effect on the next agent restart. Changes to MEMORY.md, HEARTBEAT.md, and cron.json are picked up without a restart.