agent-opslisted

# /agent-ops — Operational Actions > The verbs you need when something needs to be done to a task right now. ## Prerequisites | Var | Purpose | |---|---| | `AGENT_API_URL` | Base URL of the agent's HTTP API | | `AGENT_API_TOKEN` | Bearer token | ## Subcommands ### `/agent-ops stop <task-id>` Stop a currently-running task. The task should transition to `stopped` (or whatever your agent's stopped state is named). ```bash curl -s -X POST -H "Authorization: Bearer $AGENT_API_TOKEN" \ "$AGENT_API_URL/api/tasks/<task-id>/stop" ``` When to use: - Task is in a runaway loop - Task is doing the wrong thing (operator changed mind) - Task is consuming excessive cost / time ### `/agent-ops requeue <task-id>` Move a `failed` or `stopped` task back to `queued` so a worker picks it up again. ```bash curl -s -X POST -H "Authorization: Bearer $AGENT_API_TOKEN" \ "$AGENT_API_URL/api/tasks/<task-id>/requeue" ``` When to use: - Failure was infrastructure (`/agent-triage` classified as `infra`) - Task was stopped to prioritize something else, now ready to resume - Operator fixed a credential / env issue and wants to retry ### `/agent-ops dead-letter <task-id> [reason]` Move a task to dead-letter status. It won't be retried automatically. Optional reason logged for audit. ```bash curl -s -X POST -H "Authorization: Bearer $AGENT_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"reason": "<reason>"}' \ "$AGENT_API_URL/api/tasks/<task-id>/dead-letter" ``` When to use: