All Tools

Lifecycle, discovery, collaboration. Filter by category, search by keyword, click any card to expand its full schema.

All 13LifecycleDiscoveryCollaboration

• ticket_createlifecycle

  Create a new ticket. Always lands in backlog (s=bk).

• ticket_getlifecycle

  Fetch a single ticket with full relations (comments, links, child IDs).

• ticket_claimlifecycle

  Atomically take ownership. Moves bk/td/bl → ip.

• ticket_updatelifecycle

  Update any field. Always supply etag when working with concurrent agents.

• ticket_archivelifecycle

  Soft-delete. Sets archived_at. Excluded from all queries.

• ticket_listdiscovery

  Filter tickets across any combination of fields. Ordered by created_at DESC.

• ticket_backlogdiscovery

  Priority-ordered view of bk tickets. Use this to decide what to do next.

• ticket_boarddiscovery

  Kanban snapshot grouped by status.

• ticket_searchdiscovery

  Full-text search across title, description, labels via SQLite FTS5.

• ticket_childrendiscovery

  List children of a ticket, sorted by exec_order.

• ticket_diagramdiscovery

  Mermaid flowchart of ticket hierarchy with status colors.

• ticket_commentcollaboration

  Append a note to a ticket.

• ticket_linkcollaboration

  Create a directional relationship between two tickets.

At a glance

flowchart TB
    subgraph "Lifecycle"
        A[ticket_create]
        B[ticket_get]
        C[ticket_claim]
        D[ticket_update]
        E[ticket_archive]
    end
    subgraph "Discovery"
        F[ticket_list]
        G[ticket_backlog]
        H[ticket_board]
        I[ticket_search]
        J[ticket_children]
        K[ticket_diagram]
    end
    subgraph "Collaboration"
        L[ticket_comment]
        M[ticket_link]
    end

Lifecycle

Tool	Required	Returns	When
ticket_create	title	T{...}	Adding new work
ticket_get	id	T{...} (with cmt, lnk, ch)	Reading a single ticket
ticket_claim	id	T{s:ip,...} (atomic)	Taking ownership
ticket_update	id	T{...}	Changing any field (always send etag)
ticket_archive	id	{ok:true}	Hiding finished work

Discovery

Tool	Returns	Best for
ticket_list	[T{...}]	Filtered queries (status, type, labels)
ticket_backlog	[T{...}] priority-ordered	Start here. “What should I work on?”
ticket_board	BOARD{bk:[],ip:[],...}	Kanban snapshot
ticket_search	[T{...}] ranked	FTS5 keyword search
ticket_children	[T{...}]	Listing subtasks of a parent
ticket_diagram	Mermaid flowchart	Visualizing a hierarchy

Collaboration

Tool	Required	Returns
ticket_comment	id, body	T{...} (updated ticket)
ticket_link	from_id, to_id, link_type	{ok:true}

link_type is blk (blocks), rel (relates), or dup (duplicates).

Deeper reference

• API Guide — every parameter, every default
• Examples — annotated end-to-end workflows
• Troubleshooting — error code recovery playbook