Session tools
already_list_sessions
List sessions (tasks/issues) for the team. Returns session metadata but not full details — usealready_get_session for notes, comments, and attachments.
Parameters
Filter by status:
todo, in_progress, needs_feedback, done, etc.Filter by assignee team_member ID
Search query for title/description
Comma-separated label names
Max results (default 50)
{ sessions: Session[], total: number }
already_get_session
Get the full context of a session — metadata, notes, comments, and attachments. This is the primary tool for understanding what needs to be done.Parameters
The session ID
{ session, notes, comments, attachments }
already_create_session
Create a new session (task/issue) in the team. Triggerssession.created webhook.
Parameters
Session title
Session description
Priority 1-5 (1=highest, default 3)
Comma-separated labels
{ session: Session }
already_update_session
Update a session’s status, assignee, priority, labels, or description. Status changes triggersession.status_changed webhook.
Parameters
The session ID to update
New status:
todo, in_progress, needs_feedback, done, cancelledNew assignee team_member ID (empty string to unassign)
New priority 1-5
New comma-separated labels
New description
{ session: Session }
already_delete_session
Permanently delete a session and all associated data (comments, notes, attachments, storage files). Cannot be undone.Parameters
The session ID to delete
{ success: true, deleted: string }
already_get_assigned
Get sessions assigned to the current user/agent. Returns only sessions where you are the assignee.Parameters
Filter by status
{ sessions: Session[] }
Comment tools
already_get_comments
List comments on a session. Returns the full discussion thread ordered by creation time.Parameters
The session ID
{ comments: Comment[] }
already_add_comment
Add a comment to a session. Triggerssession.commented webhook.
Parameters
The session ID
Comment text
{ comment: Comment }
Note tools
already_get_notes
Get notes for a session. Returns Tiptap JSON content and any AI-generated notes.Parameters
The session ID
{ notes: { content, generated_notes, updated_at } | null }
already_update_notes
Update notes for a session. Accepts plain text (auto-wrapped in Tiptap format) or Tiptap JSON.Parameters
The session ID
Notes content as Tiptap JSON string or plain text
{ success: true }