For the complete documentation index, see llms.txt. This page is also available as Markdown.

Linking Sessions and Tracked Items

Link AI sessions to tracker items so the conversation behind a bug fix or a design decision stays attached to the work item it produced.

Linking a session to a tracker item keeps the conversation behind a bug fix or a design decision attached to the item it produced, so you can get back to either one from the other. This page covers item-to-session links; for links to git commits, see Commits and Session Linking, and for relationships between items, see Linking Tracker Items.

Session Linking

Session linking is deliberate. Creating or updating an item does not automatically attach every active session. Link the session when the conversation is part of the item's implementation or decision history:

  • Ask the agent to create an item and link it to the current session

  • Tell the agent to link an existing item while it updates the item's status or fields

  • Open the item and choose Link Existing to select a session yourself

  • Choose Launch Session to start a new session from the item

The connection is bidirectional:

  • From an item: The detail view shows all linked sessions. Click any session to jump back to that conversation.

  • From a session: The agent sidebar panel shows tracker items linked to the current session. Click any item to open its detail view.

Linked Tracker Items Sidebar

The agent sidebar's Trackers section listing one linked bug item with an in-review status badge
The Trackers section of the agent sidebar, showing a bug linked to the current session with its status badge.

In agent mode, a dedicated sidebar panel shows all tracker items linked to the current session. This panel updates when the agent or a person adds a link, giving you a live view of the work associated with the conversation.

Closing the loop

Session and commit linking connect planning to execution. You can start with an idea, track it through a decision, assign it as a task, link it to the AI session that implemented it, and see the commits that shipped it, all from the item's detail view.

Last updated