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
string
Filter by status:
todo, in_progress, needs_feedback, done, etc.string
Filter by assignee team_member ID
string
Search query for title/description
string
Comma-separated label names
number
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
string
required
The session ID
{ session, notes, comments, attachments }
already_create_session
Create a new session (task/issue) in the team. Triggerssession.created webhook.
Parameters
string
required
Session title
string
Session description
number
Priority 1-5 (1=highest, default 3)
string
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
string
required
The session ID to update
string
New status:
todo, in_progress, needs_feedback, done, cancelledstring
New assignee team_member ID (empty string to unassign)
number
New priority 1-5
string
New comma-separated labels
string
New description
{ session: Session }
already_delete_session
Permanently delete a session and all associated data (comments, notes, attachments, storage files). Cannot be undone.Parameters
string
required
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
string
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
string
required
The session ID
{ comments: Comment[] }
already_add_comment
Add a comment to a session. Triggerssession.commented webhook.
Parameters
string
required
The session ID
string
required
Comment text
{ comment: Comment }
Note tools
already_get_notes
Get notes for a session. Returns Tiptap JSON content and any AI-generated notes.Parameters
string
required
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
string
required
The session ID
string
required
Notes content as Tiptap JSON string or plain text
{ success: true }