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:

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.

  1. Get the file kestrel.mcpb.
  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 spend 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://kestrel.widal.com
  1. Kestrel 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. 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.