Docs
Install Widal.Code on your computer, then link the computer to your team's board.
Install in Claude Code
Widal.Code comes as a plugin for Claude Code. Until its next release, the plugin, its command and its repository still carry the earlier name, Kestrel. 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 from Widal.Code's public repository on GitHub. The third sets Widal.Code up and says each thing it does:
- It copies Widal.Code 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.
Widal.Code 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' use and its cost in a chat in the Claude desktop app. It needs no terminal and no Claude Code. It is for macOS and Linux.
- Download
kestrel.mcpbfrom Widal.Code's newest release on GitHub. - 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 use 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://code.widal.com
- Widal.Code 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. Widal.Code 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 Widal.Code sends.
The board commands
kestrel board login https://code.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 Widal.Code 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 API value of the last 7 days by day, project and model, and what it paid for.
kestrel tickets- The API value 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.