| name | agent-team-task-start |
| description | agent-team: Mark an assigned task in progress. |
| metadata | {"version":"1.0.0","openclaw":{"category":"agent-orchestration"},"requires":{"bins":["agent-team"],"skills":["agent-team-shared","agent-team-task"]},"cliHelp":"agent-team task start --help"} |
task start
PREREQUISITE: Read ../agent-team-shared/SKILL.md.
Mark a task as in_progress and record the current state_version.
Usage
agent-team task start --task TASK_ID --agent AGENT
Flags
| Flag | JSON key | Required | Default | Description |
|---|
--task | task_id | yes | - | Task to claim as in_progress. |
--agent | agent | yes | - | Caller identity; must match the task assignee. |
Examples
agent-team task start --task task_docs --agent writer
agent-team task start --params '{"task_id":"task_docs","agent":"writer"}'
Errors
| Code | Meaning | Action |
|---|
agent_mismatch | Agent is not the task assignee. | Reassign or use the assigned agent. |
not_found | Task does not exist. | Check the task ID. |
invalid_task_state | Task is not in a startable state (for example already in_progress, done, blocked, failed, or cancelled). | If already in_progress, skip task start and continue work. For blocked or failed, ask the orchestrator before retrying. For done or cancelled, do not mutate the task. |
validation_error | Required field is missing. | Provide task and agent. |
See Also