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. Pass branch to scope the epic to a git branch (use "current" to auto-detect).

List epics for a project with task counts and completion stats. Optionally filter by status, priority, or branch. Pass branch="current" to auto-detect the active git branch; pass empty string to list only branch-agnostic epics.

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 with optional filters. If no epic_id given, lists across ALL epics. Includes subtask counts and dependency info. Pass branch="current" to restrict to tasks whose epic is scoped to the active git branch.

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

Update a task. Pass only fields to change. Status transitions are automatically logged in the activity log.

Create one or more subtasks (checklist items) for a task. Accepts a single title string or an array of title strings for batch creation.

Update a subtask title, status, or sort order.

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

Create or update a note. Notes capture decisions, context, progress, meeting notes, blockers, technical details, or release info. If "id" is provided, updates the existing note; otherwise creates a new one.

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 all comments on a task in chronological order.

Create a reusable task template. Templates define a set of tasks that can be instantiated into any epic. Use {variable} placeholders for dynamic values.

List all available task templates.

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

Delete a task template.

Get a comprehensive project overview in a single call. Returns: project info, all epics with task counts, overall stats (total/done/blocked/in_progress), recent activity, and recent notes. This is the best first tool to call when starting work on a project. Pass branch="current" to scope the dashboard 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 across ALL entities (projects, epics, tasks, notes) by keyword. Returns categorized results. Pass branch="current" to restrict epic/task matches to the active git branch (projects and notes are not branch-scoped).

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

Show what changed since a given timestamp. Returns aggregated summary with counts by action and entity type, plus highlights of key changes. Call this at the start of a session to understand what happened since the last one.

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.