> ## 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.

# Reports and packages

> Generate Markdown, JSON, or CSV reports, interpret agent effort and token efficiency, and package task evidence for review.

## Generate a report

```bash theme={"system"}
bean report --date today
bean report --date week
bean report --date all --format json
bean report --date week --format csv
```

`--format` supports `md`, `json`, and `csv`. There is no separate `bean export` command.

## Interpret effort and token efficiency

Markdown and JSON reports include per-agent usage plus effort and token-efficiency data for enabled agents.

* Estimated effort uses three minutes per agent turn. Treat it as a read-only comparison metric, not elapsed time.
* Tokens per task divides tokens from sessions with linked Tasks by the number of linked Tasks.
* An agent without linked Tasks shows `N/A` in Markdown and has no `tokensPerTask` field in JSON.
* CSV reports contain Task rows only.

## Include Chronicle evidence

```bash theme={"system"}
bean report --date week --include-chronicle
```

This adds linked evidence and suggestions that still need review. Without `--include-chronicle`, the report stays focused on canonical Taskbean tasks.

## Package work

```bash theme={"system"}
bean package 42
bean package --date week --format json
```

Use packages when you need a focused task handoff or machine-readable evidence bundle. Use reports for time-based rollups.


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