Create a task. priority is 1 (highest)–5; size is XS/S/M/L/XL; dates are ISO 'YYYY-MM-DD'; project is a project name (created if new). Pass parent_id to make this a sub-task (nesting is limited to one level). When guess_dates is true (default), a missing start date defaults to the next working day and a missing due date to a few business days later; pass false to leave dates unset.

Update a task. Omit a field to leave it unchanged; pass an empty string to clear an optional field (description, project, size, dates). Set parent_id to re-parent (one level max), or clear_parent=true to detach.

Link the AI agent session you're working in to a task, so it can be resumed later. agent is 'claude-code' or 'github-copilot-cli'; directory is the absolute working directory of this session; session_id is this session's own id (used with --resume) if you know it; launcher is the command or shell alias used to start the agent (it selects the profile, e.g. 'claude-work') — omit to use the agent's default command. Re-linking replaces any previous link. Call this when you start or resume work on a task.

Remove the AI session link from a task.

Flag a task as awaiting the user's attention — e.g. you need a decision or input to proceed. note should say what you need (a short question). This makes the task stand out and rings a bell in the user's interactive board. Call clear_attention once the user has responded.

Clear a task's 'needs attention' flag once the user has responded.

Sync external items into tasks, deduplicated by (source, external_id).

    Each item needs 'external_id' (the stable dedup key within `source`) and
    'title'; optional: description, url, project, labels, priority (1–5), size,
    scheduled_date, due_date (ISO). Re-running upserts instead of duplicating:
    new items are created, existing non-terminal ones have their title/description
    refreshed (your triage is kept), terminal ones are left alone. With
    `close_missing`, previously-ingested tasks absent from this batch are completed.

Full task detail including status history and extracted references.

List tasks with structured filters. By default terminal tasks (completed/cancelled) are hidden unless include_terminal is true. Use parent_id for one task's sub-tasks, or top_level_only to hide sub-tasks.

Fuzzy-search tasks over title and description; ranked, best first.

Search URLs extracted from task descriptions (fuzzy on url + anchor).

Change a task's status, recording the transition (comment optional). Statuses: waiting, in_progress, blocked, completed, cancelled.

Overdue, today, upcoming (next N days), and in-progress/blocked tasks.

Propose a non-persistent day-by-day schedule of open tasks, greedily packed into a daily focus budget (default from config) and ordered by started-then-priority-then-due. Counts working days — weekends are skipped unless include_weekends. Narrow the candidates with projects/labels (include) or exclude_labels (drop private work); each falls back to config. The suggested day is not saved to the task.

Create a project. Project labels describe the project (e.g. the company).

List projects.

Archive a project (kept, not deleted).

List labels WITH descriptions — read these to know what each label means and when to apply it before labelling or prioritising.

Set or update a label's description (creates the label if new).