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:

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.

  1. Download kestrel.mcpb from Widal.Code's newest release on GitHub.
  2. In the Claude app, open Settings, then Extensions.
  3. Drag kestrel.mcpb onto 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?"

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
  1. Widal.Code shows an address and a code, and opens your browser.
  2. Sign in, check that the code and the computer's name are right, and pick the team if you have more than one.
  3. 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.