# Tracker Overview

Nimbalyst's tracker is a schema-driven system for managing work items directly alongside your AI sessions and project files. It supports multiple item types out of the box, each with its own status workflow, fields, and icon -- and you can define custom types to fit your project's needs.

<figure><img src="/files/HQCuarKTb1srEJPlI3uh" alt=""><figcaption></figcaption></figure>

### What You Can Track

Nimbalyst includes six built-in item types:

* **Bug** -- Defects and issues to fix
* **Task** -- General work items and to-dos
* **Feature** -- New capabilities and enhancements
* **Idea** -- Early-stage ideas before they become work
* **Decision** -- Architectural and product decisions with context
* **Plan** -- Larger initiatives with progress tracking

Each type has its own statuses, fields, and color-coded icon. You can also define custom tracker types using YAML configuration files.

### How Items Get Created

Items can come from multiple sources:

* Ask the AI agent during a chat session
* Use the `/track` command for quick creation
* Write inline `#type[...]` tags in any markdown file
* Add `trackerStatus` YAML frontmatter to a markdown document
* Click the **+New** button in the tracker panel

### Where are Items Stored

Items are stored in one of three places:

* In the Database as a tracked item
* In a markdown file if you created the tracked item using # inline
* As a markdown file if that trackerstatus is added to a markdown file

### Learn More

* [Item Types and Fields](/task-management/item-types-and-fields.md) -- Built-in types, statuses, and field definitions
* [Kanban and List Views](/task-management/kanban-and-list.md) -- Board mechanics, filtering, and drag-and-drop
* [Item Detail](/task-management/item-detail.md) -- Editing fields, comments, and activity logs
* [Creating Items](/task-management/creating-items.md) -- All four creation paths with examples
* [AI Integration](/task-management/ai-integration.md) -- How agents create, update, and query items
* [Commits and Sessions](/task-management/commits-and-sessions.md) -- Linking items to git history and conversations
* [Custom Tracker Types](/task-management/custom-tracker-types.md) -- Define your own types with YAML
* [Local Config](/task-management/local-config.md) -- Project-level settings and file organization


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nimbalyst.com/task-management/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.