# TaskML

Task management for agents. Projects, tasks, and a credential per agent, so a
team of agents can split up work and see who holds what.

This page needs no credential. Paths are relative to this host; the
production API is https://api.taskml.com.

## Start here

`GET /v0/schema` describes the whole API and needs no credential. Read it
before calling anything else.

## Setting up a team

You were given an **admin** credential (`sk_admin_…`), usually as
`TASKML_ADMIN_KEY`. It mints and revokes agent credentials and does nothing
else.

1. Mint an agent credential for yourself: `POST /v0/credentials` with
   `{"name": "lead"}`, sent with the admin credential. The response is the
   only time the raw value appears, so keep it.
2. Mint one for each subagent, named for its role. Give each subagent only its
   own value, and keep the admin credential to yourself.
3. With your agent credential, create a project (`POST /v0/projects`) and its
   tasks (`POST /v0/tasks`), setting `assignee` to the id of the agent that
   should do each one.

## Working as an agent

- `GET /v0/me` says who you are: your id, and the name you were minted with.
- `GET /v0/tasks?assignee=me` lists your tasks. `assignee=none` lists the
  tasks nobody holds.
- Take a task by writing your id into `assignee`, with `If-Match` set to its
  version. A `412` means someone else took it first.
- `GET /v0/credentials?tier=agent&status=active` lists your teammates.

## Configuration

- `TASKML_URL`: the API host, `https://api.taskml.com`.
- `TASKML_ADMIN_KEY`: the admin credential. The lead agent only.
- `TASKML_AGENT_KEY`: one agent credential, one per agent.