action to pick the operation. Writes need the work:write scope; an API key acts with the role of the member who created it.
Projects and cards
driftless_project_card action:'next' is the loop tick: it returns the next actionable card plus its context bundle in one call.
| Tool | Actions | Main params | Notes |
|---|---|---|---|
driftless_project | list, get, set | id (omit to create), title, goal | does not expose playbook_slug yet |
driftless_project_card | list, get, add, set, move, delete, next | project_id, card_id, status, owner | next returns { card, context_bundle, project_done } |
work:write. Availability: Available. Card verification is report-and-surface: the server stores the validate command and the result you report, and never runs it.
Collections and records
driftless_collection action:'retrieve' delivers both halves of the seam at once: the relevant records plus the criterion Knowledge to read first. For criterion only, use action:'context'.
| Tool | Actions | Main params | Notes |
|---|---|---|---|
driftless_collection | list, get, add, update, doctor, context, retrieve | id, query, status, view, limit, cursor | retrieve returns { records, nextCursor, criterion, criterion_missing } |
driftless_collection_record | list, get, add, update | collection_id, record_id, fields, status, entity_id | status is validated against the collection’s stages |
work:write. Availability: Available.
Entities
An Entity is a cross-collection identity that records point at. It upserts idempotently on(kind, dedup_key): writing the same pair twice updates it instead of creating a duplicate.
| Tool | Actions | Main params | Notes |
|---|---|---|---|
driftless_entity | list, get, upsert | kind, name, dedup_key, attributes | idempotent on (kind, dedup_key) |
list / get are member-level; upsert needs work:write. Availability: Available.
Permissions
| Scope | Covers |
|---|---|
work:write | Create and update projects, cards, collections, records, and entities |
| member (read) | list / get / next / context / retrieve / doctor |
work:write covers the whole work and operations plane.
Availability
| Capability | State |
|---|---|
Projects, cards, and the next loop | Available |
| Collections, records, and the criterion seam | Available |
Entity dedup on (kind, dedup_key) | Available |
playbook_slug on driftless_project | Not available (set it from the CLI or API) |
Server-side execution of a card’s validate | Not available (report-and-surface only) |
Related
- Projects, Collections - the concepts.
- Continue a project across agents, Operate a Collection - the workflows.
- CLI: Projects, CLI: Collections - the terminal surface.
- MCP & OAuth - setup, auth, and scopes.