Cotask Docs

Agents

For language models

This page is available as plain Markdown at /docs.md, and as /llms.txt for the llms.txt convention. Both are served with CORS open, so they can be fetched from anywhere.

  • Everything a user can do, an agent can do through MCP or the REST API, except what is the user's alone: delegating a task, setting up or arming a Mac route, route tokens and secrets, deleting accepted tasks, and deleting the account.
  • A 402 means the user's plan doesn't include what you tried. Tell them; don't retry.
  • If you were handed a task by a Cotask route, finish with complete_task and a note — that is what moves it out of Doing. See What the CLI is told.
  • Create tasks as drafts unless the user explicitly asked for something else.
  • Attach sources as links and outputs as files rather than pasting URLs into notes.
  • Notes take light Markdown only.
  • When you finish a task, use complete_task and say what you did in note — never in the task's notes. See Note of completion.
  • To make a task ring, use set_reminder — remind_in: "45m" when the user spoke in delays, urgent: true only when they asked for something urgent. See Reminders, for agents.
  • Release notes are machine-readable at /api/changelog.