AI Integration

AI agents in Nimbalyst have full access to the tracker system. They can create, update, and query items during sessions, and every interaction is automatically linked for traceability.

Creating Items

During a coding or planning session, the AI can create tracker items on the fly when it identifies work to track:

"I found a potential memory leak in the WebSocket handler. I've created a bug item to track it."

You can also ask the agent directly:

"Create a task for updating the API documentation" "Log an idea: real-time collaboration for the editor" "Track a decision: we chose Tailwind over styled-components"

The agent selects the appropriate type, sets fields based on your description, and creates the item.

Updating Items

Ask the agent to modify existing items:

"Mark the login bug as done" "Set the database migration plan to in-progress and assign it to me" "Add a comment to bug #123 saying the fix is in PR #456" "Change the priority of the caching task to critical"

The agent can update any field: status, priority, owner, description, tags, and progress.

The agent can also reclassify an item to a different type — for example, turning a task into a bug — without losing its comments, attachments, or session links. Just ask:

"Convert task #42 to a bug" "This idea is actually a feature, reclassify it"

Querying Items

Ask about your project's current state:

"What bugs are currently open?" "Show me all high-priority tasks assigned to me" "List decisions made this month" "How many items are in the In Review column?" "Find all items tagged with 'backend'"

The agent can filter by type, status, priority, owner, tags, and perform full-text search across titles and descriptions.

Session Linking

When an agent creates or updates a tracker item with an explicit link (via linkSession: true on tracker_create, or by calling tracker_link_session), the item is connected to that session. This means:

• From any item, you can see which sessions touched it

• From any session, you can see which items were created or modified

• You can trace the full history of an item back to the conversations that shaped it

tracker_create does not auto-link the calling session — the agent must opt in. This keeps sessions from accumulating unrelated tracker items when the agent is just logging work in passing.

Transcript Widgets

Tracker operations performed by the agent appear as structured widgets in the chat transcript, not just plain text. Each widget shows the item type, title, status, and other key fields. Click the widget to navigate directly to the item in the tracker.

This makes it easy to review what the agent created or changed without scrolling through conversation text.