> For the complete documentation index, see [llms.txt](https://docs.nimbalyst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nimbalyst.com/task-management.md).

# TASK MANAGEMENT

- [Tracker Overview](https://docs.nimbalyst.com/task-management/overview.md): Nimbalyst has a built-in issue tracker that keeps bugs, features, tasks, and plans in your project, next to your docs and AI sessions.
- [Item Types and Fields](https://docs.nimbalyst.com/task-management/item-types-and-fields.md): Nimbalyst ships seven built-in tracker item types, each with its own status workflow, fields, and icon. Learn what each type is meant to track.
- [Views: Kanban, List, and Tag Board](https://docs.nimbalyst.com/task-management/kanban-and-list.md): Switch between kanban board, list, and tag board views in the Nimbalyst tracker, then save any filter and grouping as a named view to reuse.
- [Item Detail, Comments, Activity](https://docs.nimbalyst.com/task-management/item-detail.md): Open a tracker item to edit fields in place, write the body, add comments, and follow the full activity history of a piece of work.
- [Creating Items](https://docs.nimbalyst.com/task-management/creating-items.md): Several ways to create tracker items in Nimbalyst, from asking your AI agent during a session to writing inline tags or YAML in markdown.
- [Referencing Tracker Items](https://docs.nimbalyst.com/task-management/referencing-tracker-items.md): Drop a live reference to any tracker item into a document or AI chat. The chip shows the current status and title and stays up to date.
- [Linking Tracker Items](https://docs.nimbalyst.com/task-management/linking-tracker-items.md): Link tracker items to each other with parent, blocks, and duplicate relationships. Links are two-way, so setting one side updates the other.
- [Sharing Plans and Trackers](https://docs.nimbalyst.com/task-management/sharing-plans-and-trackers.md): How to share Nimbalyst plans and tracker items with teammates, and how personal and shared trackers differ in practice.
- [AI Integration](https://docs.nimbalyst.com/task-management/ai-integration.md): AI agents in Nimbalyst can create, update, and query tracker items during a session. Link the ones that matter, or turn agent access off.
- [Commits and Session Linking](https://docs.nimbalyst.com/task-management/commits-and-sessions.md): Reference a tracker item ID in a git commit message and Nimbalyst links that commit to the item, giving traceability from idea to shipped code.
- [Linking Sessions and Tracked Items](https://docs.nimbalyst.com/task-management/linking-sessions-and-tracked-items.md): 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.
- [Custom Tracker Types](https://docs.nimbalyst.com/task-management/custom-tracker-types.md): Define your own tracker types in Nimbalyst with YAML config files or from Settings. Custom types get the same board, detail view, and AI integration.
- [The nim CLI](https://docs.nimbalyst.com/task-management/nim-cli.md): nim is a command-line tool for Nimbalyst trackers. List, create, update, comment, archive, and import items from your shell, and pipe JSON out.
- [Local Config](https://docs.nimbalyst.com/task-management/local-config.md): Where Nimbalyst keeps tracker type definitions and markdown-backed items, and which tracker settings live in the app.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.