Set the current project context.

Called at session start with $PWD.

Get the current project context.

Create a new issue, todo, feature, epic, or diary entry for current project.

List items for current project with optional type/status/tag filters.

Get full details of a specific item.

Move item to next status in its workflow.

Move item to previous status in its workflow.

Set item to a specific status (must be valid for item type).

Mark item as done/closed.

Permanently delete an item.

Edit an existing item's title, description, priority, complexity, and/or parent.

Note: Empty string/zero means 'don't update this field'. To clear description, use a single space. Complexity 0 means 'don't update'. Parent -1 means 'don't update', 0 means 'remove parent'.

Add a progress update, optionally linked to items (comma-separated IDs).

Get the most recent update for current project.

Get recent updates for current project.

Get summary of items by type and status for current project.

Get items in 'in_progress' status for context during work.

Get items in 'backlog' status - the todo queue for current project.

Add a relationship between two items.

Types: 'blocks' (source blocks target from completing), 'depends_on' (source depends on target being complete), 'relates_to' (informational), 'duplicates' (informational)

Remove a relationship between two items.

Get all relationships for an item (both directions).

Get items that block this item from being completed.

Get progress stats for an epic: total, completed, percent, incomplete_items.

Set or remove parent relationship. Use parent_id=0 to remove parent.

Get children of an item. Set recursive=True to get all descendants.

List all tags in current project with usage counts.

Add a tag to an item (creates tag if it doesn't exist).

Remove a tag from an item.

Get all tags assigned to an item.

Update tag name and/or color.

Delete a tag from current project (removes from all items).

Get status change history for an item, ordered chronologically.

Get calculated metrics for an item: lead_time, cycle_time, time_in_each_status, revert_count, current_age (all times in hours).

Export project data in JSON, YAML, or Markdown format.

Args: format: Output format - 'json', 'yaml', or 'markdown' item_type: Filter by type (issue, feature, epic, todo, diary, question) status: Filter by status (backlog, todo, in_progress, review, done, closed) item_ids: Comma-separated item IDs to export (overrides type/status filters) include_tags: Include tag data for each item (default: True) include_relationships: Include relationship data include_metrics: Include calculated metrics (lead_time, cycle_time, etc.) include_updates: Include project updates include_epic_progress: Include epic progress stats detailed: For markdown, show detailed item info instead of tables limit: Maximum items to export (default: 500)

Returns: Dict with success, format, content, and item_count

Full-text search across items and updates in current project.

Args: query: Search query string limit: Maximum results per category (default 20)

Returns: Dict with items, updates, and total_count

Link a file (or file region) to an item.

Args: item_id: The item to link the file to file_path: Relative path to the file line_start: Optional starting line number line_end: Optional ending line number

Returns: Dict with success status and link_id if successful

Remove a file link from an item.

Args: item_id: The item to unlink the file from file_path: Relative path to the file line_start: Optional starting line number (must match to unlink) line_end: Optional ending line number (must match to unlink)

Returns: Dict with success status

Get all files linked to an item.

Args: item_id: The item ID to get files for

Returns: Dict with success status and list of files

Add a decision record to an item.

Args: item_id: The item to attach the decision to choice: What was decided (max 200 chars) rejected_alternatives: What was rejected (max 500 chars) rationale: Brief reason for the choice (max 200 chars)

Get all decisions for an item.

Delete a decision record.

Search items, decisions, and updates by semantic similarity.

Args: query: Natural language search query limit: Maximum results to return (default: 10) source_types: Comma-separated types to search (item,decision,update). Empty = all threshold: Minimum similarity score 0.0-1.0 (default: 0.0)

Returns: Dict with success, results list (each with source_type, source_id, similarity, title/snippet)

Find items similar to a given item, decision, or update.

Args: source_type: Type of source ('item', 'decision', 'update') source_id: ID of the source to find similar to limit: Maximum results (default: 5) threshold: Minimum similarity 0.0-1.0 (default: 0.0)

Returns: Dict with success, results list (excluding the source itself)

Rebuild all embeddings for the current project.

Args: source_types: Comma-separated types to rebuild (item,decision,update). Empty = all

Returns: Dict with success, processed count, and any errors

Get activity timeline for a specific item.

Returns unified timeline of status changes, decisions, updates, and git commits.

Args: item_id: The item to get timeline for limit: Maximum entries to return (default: 100)

Returns: Dict with success, entries list (sorted by timestamp desc), entry_count

Get activity timeline for the entire project.

Returns unified timeline of all status changes, decisions, updates, and git commits.

Args: limit: Maximum entries to return (default: 100)

Returns: Dict with success, entries list (sorted by timestamp desc), entry_count