Content
# Beezi plugins for Claude
Official Beezi plugins for Claude — track the cost of AI-assisted work per task without
leaving the conversation.
| Plugin | Platform | What you get |
| --- | --- | --- |
| `beezi` | Claude Code (terminal) | Automatic session analytics per Beezi task branch |
The plugin signs in with your own Beezi account — you must already be a Beezi user, and
everything happens as you, on your tenant.
## Claude Code — `beezi`
### 1. Install
```
/plugin marketplace add https://github.com/Beezi-AI/beezi-claude-code
/plugin install beezi@beezi
```
### 2. Link your machine
```
/beezi:login
```
Approve the sign-in in your browser. That's it — from now on, work on Beezi task branches
is tracked automatically; you don't need to run anything else.
### Commands
| Command | Purpose |
| --- | --- |
| `/beezi:login` | Link this machine via browser sign-in; the token is kept in your OS secret store. |
| `/beezi:me` | Show whether this machine is linked, and as whom. |
| `/beezi:logout` | Unlink this machine — revokes its access and removes the stored credentials. |
| `/beezi:track` | Force-save this session's analytics mid-session. |
| `/beezi:refresh` | Re-capture your Claude subscription plan for accurate cost reporting. |
### Personal analytics summary
Run `/beezi:analytics` for a short read on your own Claude Code usage — spend, sessions,
top model, an alert status, and up to three recommendations. `/beezi:analytics 30d` widens
the window from the default 7 days. The summary always covers just you, whatever your role
or plan, and the wording is generated by your own model from figures Beezi returns.
### Optional configuration
| Variable | Default | Purpose |
| --- | --- | --- |
| `BEEZI_API_URL` | `https://beezi-api-prod.azurewebsites.net/api` | Beezi API base URL. |
| `BEEZI_MCP_URL` | `https://beezi-api-prod.azurewebsites.net/api/mcp` | Beezi MCP server backing `/beezi:analytics`. |
| `BEEZI_HOME` | `~/.beezi` | Local state root (queue, cursors, credentials). |
## Privacy
The analytics plugin reports token counts, tool-call counts, durations, branch and task
ids, the sanitized origin remote, and the session name. Your auth token and the contents
of `~/.claude.json` never leave the machine. Full details, including credential storage
per OS: [`plugins/beezi/README.md`](plugins/beezi/README.md).
## License
Licensed under the [Apache License, Version 2.0](LICENSE).
