Skip to main content

Cost & Budgets

Synth can track provider usage and enforce budgets. Start with simple guardrails.

Where To Look

  • Analytics: provider, model, agent, and recent call usage
  • Budget: daily, weekly, and monthly limits
  • Settings -> Models: per-agent model choices

Cheap First Workflow

  1. Use synth_search when you only need pages.
  2. Use synth_search before coding tasks.
  3. Let the connected agent synthesize from retrieved evidence.
  4. Keep background lint off until you choose a budget.

Budget Tips

  • Put extraction on an accurate model.
  • Use Explore, REST search, or MCP search/read for provider-free retrieval.
  • Let the connected coding agent perform synthesis using the evidence packet.
  • Limit large ingests until the provider setup is proven.
  • Use watchers with focused files.rules so large repos do not ingest low-signal files.

Before locking production defaults, test extraction and linking with your own sources and check the resulting knowledge quality, latency, and usage cost.

API

Budget and usage APIs live under /api/usage/*, /api/analytics/*, and /api/budget/*.

Use the UI first. Use APIs for reporting once the team workflow is stable.