Docs
Install Kestrel on your computer, then link the computer to your team's board.
Install in Claude Code
Kestrel comes as a plugin for Claude Code. Type these three commands in Claude Code:
/plugin marketplace add Widal-Inc/kestrel
/plugin install kestrel@kestrel
/kestrel:setup
The first two add the plugin. The third sets Kestrel up and says each thing it does:
- It copies Kestrel to
~/.kestrel/app/and makes the commandkestrel. - It sets Claude Code's status line. A copy of Claude Code's settings is saved first, and another tool's status line is kept.
- It adds the hooks of the security checks.
Kestrel needs Node 22 or newer. It is tested on macOS. kestrel uninstall takes it out of Claude Code again.
Install in the Claude app
The desktop extension answers questions about your agents' spend in a chat in the Claude desktop app. It needs no terminal and no Claude Code. It is for macOS and Linux.
- Get the file
kestrel.mcpb. - In the Claude app, open Settings, then Extensions.
- Drag
kestrel.mcpbonto that page, and choose Install.
Then open a new chat and ask, for example: "What did my agents spend this week, and where can I save?"
Link a computer to the board
First sign in to the board with GitHub, and install the board's GitHub App on your organization or your own account (see Get started). Then run this on each computer:
kestrel board login https://kestrel.widal.com
- Kestrel shows an address and a code, and opens your browser.
- Sign in, check that the code and the computer's name are right, and pick the team if you have more than one.
- Press Approve. Kestrel gets a token for this computer and starts to send what it records.
The token is kept on the computer. The board keeps only a hash of it. See what Kestrel sends.
The board commands
kestrel board login https://kestrel.widal.com- Links this computer to a team on the board.
kestrel board status- Shows whether this computer is linked, to which team and as whom, and when it last sent data.
kestrel board sync- Sends what Kestrel recorded and has not sent yet.
kestrel board logout- Stops this computer from sending. Its token stops working at once, and the board shows the computer as removed.
To remove a computer you no longer have, press Revoke next to it on your account page.
Commands on your computer
These work without the board, and send nothing.
kestrel summary- The spend of the last 7 days by day, project and model, and what the money paid for.
kestrel tickets- The spend per ticket, from the ticket in the git branch name.
kestrel advise- Changes that would have saved money, from a replay of the last 30 days, with the command for each.
kestrel check- The open security findings, the most severe first.
kestrel help- Every command.