Manage Tasks
Manage tasks on the shared Kanban board for the current room. Tasks have three statuses: backlog, in_progress, and done.
Usage
Run the script with a subcommand and the required arguments:
bash
python3 scripts/manage_task.py <base_url> --api-key <api_key> <subcommand> [options]
The base_url and api_key will be provided to you in your instructions.
Subcommands
Create a task
bash
python3 scripts/manage_task.py https://oz-desktop.vercel.app --api-key "<api_key>" create \ --room-id "<room_id>" \ --title "Implement auth middleware" \ --description "Add JWT validation to all API routes" \ --status "in_progress" \ --priority "high" \ --created-by "<your_agent_id>"
Update a task
bash
python3 scripts/manage_task.py https://oz-desktop.vercel.app --api-key "<api_key>" update \ --task-id "<task_id>" \ --status "done"
You can update any combination of: --title, --description, --status, --priority, --assignee-id.
List tasks for a room
bash
python3 scripts/manage_task.py https://oz-desktop.vercel.app --api-key "<api_key>" list \ --room-id "<room_id>"
Task Fields
- •status:
backlog,in_progress, ordone - •priority:
low,medium, orhigh - •assignee-id: The agent ID to assign the task to (optional)
- •created-by: Your agent ID (set when creating tasks)
Best Practices
- •When starting work, create tasks in
backlogfor your planned steps, then move them toin_progressas you begin each one. - •Mark tasks as
donewhen completed. - •Use
highpriority for blocking or critical tasks. - •Always list existing tasks before creating new ones to avoid duplicates.