Create a new project. Projects are the top-level container for all work.

List all projects with epic/task counts and completion percentages. Optionally filter by status.

Update a project. Pass only the fields you want to change. Set status to "archived" to soft-delete.

Create an epic within a project. Epics group related tasks into a feature or workstream.

List epics for a project with task counts and completion stats. Filter by status, priority or branch. Archived epics are hidden unless include_archived is set.

Archive or unarchive an epic. Archived epics and their tasks drop out of listings, the dashboard and search unless include_archived is set. For putting finished work out of sight without cancelling it; nothing is deleted.

Update an epic. Pass only the fields you want to change. Set status to "cancelled" to soft-delete. Pass branch="current" to pin to the active branch, or empty string to clear.

Create a task within an epic. Tasks are the primary unit of work.

List tasks; without epic_id, across all epics. Includes subtask and dependency counts. Rows are compact: nulls and metadata dropped, descriptions cut to 120 chars (task_get for full). branch="current" restricts to the active git branch.

Set the order of an epic's tasks. Omitted IDs keep their relative order at the end. task_list then follows this arrangement by default.

Remove a task (soft delete). Only 'todo' tasks — anything further along has history worth keeping. The row is kept and hidden from listings; task_restore brings it back.

Restore a task removed with task_delete.

Lock or unlock a task's description. While locked, task_update refuses to change it — a guard against rewriting the spec when you meant to add a comment. Every other field still changes freely.

Get a single task with full details including all subtasks, related notes, comments, and dependencies.

Update a task; pass only fields to change. Completing it while subtasks are unfinished is refused unless force is set.

Create subtasks (checklist items) for a task. Pass titles as an array — one string per subtask — and each becomes its own record. New subtasks are appended after any that exist.

Update a subtask title, status or position. depends_on sets what it waits on, blocks the inverse; both replace the set, [] clears. Starting or finishing one with unmet prerequisites needs force.

Reorder a task subtask list. Pass IDs in the order you want; any omitted keep their relative order at the end.

Delete one or more subtasks. Accepts a single ID or array of IDs.

Create or update a note: decisions, context, progress, meetings, blockers, technical detail, releases. With id, updates; without, creates.

List notes with optional filters. Returns notes sorted by most recent first.

Search across note titles and content by keyword.

Delete a note by ID.

Add a comment to a task. Comments create a chronological discussion thread — useful for leaving breadcrumbs across sessions.

List comments on a task in chronological order. Comments removed with comment_delete are hidden by default; pass include_deleted to see them with their removal reason.

Remove a comment (soft delete). The row is kept for the audit trail but hidden from comment_list and task_get. Use this to retract a comment that turned out to be wrong or stale. Reversible with comment_restore.

Restore a comment previously removed with comment_delete.

Create a reusable set of tasks that can be instantiated into any epic. {variable} placeholders are filled in on apply.

List task templates. Pass include_tasks to see what each one actually creates.

Apply a template to create tasks in an epic. Replaces {variable} placeholders with provided values.

Edit a template in place. Only the fields you pass change; tasks replace the whole list.

Delete a task template.

Full project overview in one call: project, epics with task counts, stats, blocked and overdue tasks, recent activity and notes. Best first call when starting work. branch="current" scopes to the active git branch.

Initialize the tracker for a project. If the database is empty, creates a project with the given name. If a project already exists, returns its info.

Search projects, epics, tasks and notes by keyword. Returns categorized previews — use task_get or note_list for full text.

What to work on next: one recommended task with the reason, its next unfinished subtask, alternatives, and — when nothing is actionable — what to unblock. Call it when resuming work; cheaper than tracker_dashboard.

View the activity log showing what changed and when. Useful for understanding recent progress or reviewing what happened since the last session.

What changed since a timestamp: counts by action and entity, plus the notable changes. Call it at the start of a session to catch up.

Update multiple tasks at once. Useful for changing status of several tasks (e.g., mark 3 tasks as done) or reassigning tasks.

Export a full project as nested JSON. Includes all epics, tasks, subtasks, comments, dependencies, and related notes. Useful for backup, migration, or sharing.

Import a project from JSON (matching tracker_export format). Creates all entities with new IDs and remaps references. Uses a transaction for atomicity.