| name | kandev-agent-edit |
| description | Edit or remove existing agents — rename, adjust budget, retire |
| kandev | {"system":true,"version":"0.42.0","default_for_roles":["ceo"]} |
Agent editing — adjust, rename, retire
You can edit an existing agent's settings or remove an agent that's no longer needed.
Rename or re-icon
$KANDEV_CLI kandev agents update --id A-1 --name "Senior Reviewer"
Adjust the monthly budget
$KANDEV_CLI kandev agents update --id A-1 --budget-monthly-cents 5000
Pass 0 to mean "unlimited" (subject to workspace policy). Pass -1 and the flag is ignored (allows scripted updates with optional fields).
Cap concurrent sessions
$KANDEV_CLI kandev agents update --id A-1 --max-concurrent-sessions 1
Retire an agent
$KANDEV_CLI kandev agents delete --id A-1
The backend rejects deletes for agents that are currently working. Use kandev agents list to confirm status: idle first.
When to edit vs replace
- Permission / role mistakes → edit (you cannot change
role after create — re-hire).
- Budget overrun → edit
--budget-monthly-cents.
- Skill mismatch → use the Skills page (this CLI does not toggle individual skills).
- Agent never picks up work → delete + re-hire with a different role.