io.github.thriftell/budgetary

Official1 tool

by thriftell · TypeScript

Budgetary: estimate token spend

Pre-flight, probabilistic token-spend estimate (range, scenario, confidence) for a coding task.

Estimate token spending and costs for coding tasks with probabilistic ranges and scenarios.

README.md1 KBView on GitHub

Budgetary clients

Budgetary tells you how many tokens an LLM query will cost — before you run it.

Budgetary is a hosted API at https://api.budgetary.tools that returns probabilistic pre-inference token-spend estimates for LLM queries. This repository holds the open-source clients that talk to it: language SDKs and editor plugins.

Quick example

import { BudgetaryClient } from "@budgetary/sdk";

const budgetary = new BudgetaryClient({ apiKey: process.env.BUDGETARY_API_KEY! });
const estimate = await budgetary.estimate("Summarize the attached PDF in three bullets.");

The SDK in this release is a stub — the call above illustrates the shape of the API surface, not a working implementation.

Install

See docs/installation.md for per-client setup:

TypeScript / JavaScript SDK — @budgetary/sdk on npm
Python SDK — budgetary on PyPI
VS Code extension (dashboard)
Claude Code plugin
Codex plugin

API

Bearer-auth HTTP API at https://api.budgetary.tools. The wire contract is published at docs/api-contract.md.

Status

Early access. The hosted API is live, but client interfaces may change between releases until they reach 1.0. Pin exact versions in production.

License

Apache-2.0. Copyright Budgetary.

Install

Configuration

Environment variables

BUDGETARY_API_KEYrequiredsecret

Budgetary API key (bg_live_ or bg_test_ prefix). Get one at https://budgetary.tools.

claude_desktop_config.json

{
  "mcpServers": {
    "budgetary": {
      "command": "npx",
      "args": [
        "-y",
        "@budgetary/mcp@0.1.1"
      ],
      "env": {
        "BUDGETARY_API_KEY": "<YOUR_BUDGETARY_API_KEY>"
      }
    }
  }
}