> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taskbean.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat taskbean/taskbean as the source of truth for product behavior.
> Use the canonical Project, Project ID, Project Key, Project Alias, Project Selector, Workspace, Tracked Project, Tracked Workspace, Discovered Workspace, Remote Workspace, Primary Workspace, Agent Session, Copilot Fork, Task, Unassigned Work, Execution Profile, Kickoff Prompt, Execution Record, and Execution Step terminology from the glossary.
> Execution terms are domain definitions, not evidence of available CLI commands or desktop controls.
> Do not infer that Windows-specific desktop features apply to the cross-platform CLI.

# Chronicle app workflow

> Review Chronicle suggestions in the Taskbean desktop app and keep evidence separate from canonical tasks.

Use the desktop app when you want a visual review queue for suggestions and their source sessions.

## Review a suggestion

1. Open the Chronicle review surface.
2. Inspect the evidence summary, confidence, source session, repository, branch, and changed-file references.
3. Choose one outcome:
   * Approve it as a new Task.
   * Link it to an existing Task.
   * Ignore it.
4. Use undo when an automatic link needs human review.

## API operations

| Operation | Endpoint |
| - | - |
| List suggestions | `GET /api/chronicle/suggestions` |
| Approve | `POST /api/chronicle/suggestions/:id/approve` |
| Link | `POST /api/chronicle/suggestions/:id/link` |
| Ignore | `POST /api/chronicle/suggestions/:id/ignore` |
| Undo an automatic link | `POST /api/chronicle/suggestions/:id/undo-auto-link` |

<Warning>
  A pending suggestion is review evidence, not a Task. Approve it to create a Task, or link it to an existing Task without changing that Task's status.
</Warning>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.