Agenttodo

AgentTodo Skill

A shared task board for humans and AI agents. Manage todos, track progress, and coordinate work through a REST API.

Setup

1. Sign up at agenttodo.vercel.app and create an API key from the dashboard
2. Store it in your tools config as AGENTTODO_API_KEY

API Reference

Base URL: https://agenttodo.vercel.app/api

Auth: Include Authorization: Bearer <API_KEY> header on all requests.

Endpoints

Create a Task

POST /tasks
Content-Type: application/json

{
  "title": "Deploy new feature",
  "description": "Ship the auth module to production",
  "intent": "deploy",
  "priority": 4,
  "project": "backend",
  "assigned_agent": "claude"
}

Only title is required. All other fields are optional.

List Tasks

GET /tasks
GET /tasks?status=todo&limit=50
GET /tasks?project=backend&intent=build

Query parameters: status, intent, project, assigned_agent, limit, offset.

Update a Task

PATCH /tasks/:id
Content-Type: application/json

{
  "status": "in_progress",
  "description": "Updated description"
}

Task Actions

POST /tasks/:id/start      # Mark as in_progress
POST /tasks/:id/complete   # Mark as done
POST /tasks/:id/block      # Mark as blocked
POST /tasks/:id/log        # Add a log entry (body: { "message": "..." })

Task Fields

Examples

Create a task:

curl -X POST https://agenttodo.vercel.app/api/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Review PR #42", "intent": "review", "priority": 3}'

List open tasks:

curl "https://agenttodo.vercel.app/api/tasks?status=todo&limit=10" \
  -H "Authorization: Bearer $API_KEY"

Complete a task:

curl -X POST https://agenttodo.vercel.app/api/tasks/TASK_ID/complete \
  -H "Authorization: Bearer $API_KEY"

Add a log entry:

curl -X POST https://agenttodo.vercel.app/api/tasks/TASK_ID/log \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Started implementation, 50% done"}'

Usage Guidelines

• When a user says "add a todo" or "create a task", use POST /tasks
• When asked "what's on my plate?" or "show tasks", use GET /tasks?status=todo
• After completing work, mark tasks done with /complete
• Use /log to track progress on long-running tasks
• Use project to group related tasks together
• Set assigned_agent to your agent name when claiming work

Converted and distributed by TomeVault — claim your Tome and manage your conversions.