Pricing
How Billing Works
Macroscope uses a prepaid usage model. Each workspace has a single balance that covers Code Review, Status, and Agent, and decreases with usage. Enable Auto-refill to have your balance top up automatically when it falls below a threshold you configure, so there’s no disruption.How do I set up auto-refill?
How do I set up auto-refill?
How do invoices work?
How do invoices work?
How do I manage my payment method?
How do I manage my payment method?
Why does my usage data look off in the billing dashboard?
Why does my usage data look off in the billing dashboard?
Does my balance expire?
Does my balance expire?
What happens if I cancel?
What happens if I cancel?
Spend Controls
You can set several limits to control your costs. Configurable by a workspace admin in Settings → Billing.What the Correctness per-PR cap counts, and what it stops
The per-PR cap measures one thing and stops two, and the difference matters when you are working out why a check did not run. What counts toward the cap: Code Review (correctness) runs on that PR, and nothing else. Check Run Agent and Approvability spend on the PR does not add to the total, and neither does spend that is not attached to a PR at all — Ask Macroscope Anything, Macros, and CLI reviews. What stops once the cap is reached: Code Review and Approvability on that PR.- Code Review stops before exceeding the cap; the agents stop after reaching it. Code Review’s maximum cost is known before it runs, so it is skipped when the spend already booked plus this review’s estimate would go over. An agent’s cost cannot be estimated up front, so agents are stopped only once booked spend has already reached the cap.
- Spend before usage-based billing began does not count. Only Code Review runs recorded under usage-based billing are totalled, so a long-lived PR is not charged against the cap for work that predates it.
@macroscope-app review this PR bypasses the per-PR cap and reviews the PR now. The monthly spend limit is not bypassable this way — it applies to on-demand reviews too.The Check Run Agents per-PR limit
Check Run Agents have their own workspace-wide per-PR limit, separate from the Correctness caps above. It defaults to $100. It is one shared budget across every agent on the PR. A workspace running ten agents gets one ceiling for all of them, not ten. Once their combined recorded spend on a PR reaches the limit, remaining automatic agent runs on that PR are created and concluded skipped, naming the limit.@macroscope-app — bypasses the workspace limit and runs it, exactly as on-demand review bypasses the Correctness cap. The per-PR limits pace what a single pull request spends on its own, so a deliberate request is let through. The monthly spend limit is the opposite by design: it bounds your total exposure for the billing period and cannot be overridden, on-demand runs included.
Per-agent budgets are separate and stack with it. For finer control than one workspace-wide ceiling, an individual agent can declare its own caps in the front matter of its .macroscope/*.md file. The two do different jobs:
maxBudgetPerRunbounds a single run. The agent re-checks it after each turn and stops as soon as the cap is reached, which makes it the control to reach for when you want to cut off an agent that would otherwise keep investigating. Work already done is still billed, and a run stopped this way should be read as incomplete rather than clean. Not supported withinput: code_object.maxBudgetPerPRbounds that agent’s total across every run it makes on one PR. It is checked before a run is dispatched, so it stops a further run from starting rather than interrupting one in flight.
What if my balance runs out?
What if my balance runs out?
What if I hit my monthly max?
What if I hit my monthly max?
How does auto-refill interact with the monthly spend limit?
How does auto-refill interact with the monthly spend limit?
CLI Review Limits
Macroscope CLI reviews consume Agent credits, and admins can cap them separately from the rest of your usage under Settings → Billing → CLI Spend Controls.- Checked before a review starts, so a review that would exceed a limit is declined and costs nothing.
- Only CLI reviews count. Code Review on GitHub, Status, and other Agent usage draw on the workspace budget but not on these limits.
- The workspace limit wins. Once it’s reached, every developer is blocked for the rest of the billing period, whatever their own limit allows.
- Best effort, not a reservation. Reviews already running are not stopped, so spend can land slightly past a limit.
- Resets each billing period. Raising a limit takes effect immediately — no need to wait for the reset.
Agent
Credits are a usage-based billing unit for Macroscope’s Agent features: Slack queries, Macros, Webhooks, Check Run Agents and Approvability. 1 credit = $0.01. Credit usage is calculated by taking the raw LLM cost of each agent run (based on your prompts and parameters), then adding a 5% markup, then dividing by the value of each credit ($0.01). Every workspace includes 1000 free credits per month. Free credits do not roll over. Usage beyond the free credits draws from your balance. Approvability is the one exception: it is priced per run at a flat 30 credits ($0.30), regardless of the size of the PR or what the run cost to produce. Runs Macroscope decides without an agent are free.What uses credits
Transparency
Workspace admins can view detailed Agent usage logs in Settings → Billing, including exporting a full CSV with cost and metadata for every agent invocation. The Agent Credit Usage card offers two views of the same data, grouped by Type, Repo Name, or Check Run Name:- Pie chart — how the billing period’s usage splits across slices.
- Daily chart — usage per day across the period. Pick a single slice to drill into just that series, with its run count, period total, and per-run low, average, and high.
Why do different queries cost different amounts?
Why do different queries cost different amounts?
What happens if I use all 1000 free credits?
What happens if I use all 1000 free credits?
Can I see my agent usage?
Can I see my agent usage?
Code Review
Code Review is charged per review, based on the byte size of the PR diff that Macroscope reviews. The per-KB price depends on the Detection Mode the review runs in. Every review has a minimum of 10 KB. If the reviewed diff is under 10 KB, you are charged for 10 KB at that mode’s rate.What counts as a review?
What counts as a review?
- Automatically on each push to a PR (if automatic Code Review is enabled for that repo)
- Manually, by commenting
@macroscope-app reviewon any PR in GitHub
How is diff size calculated?
How is diff size calculated?
.macroscope/ignore.md file, are excluded from the diff, so you only pay for the files Macroscope actually reviews.What is Detection Mode?
What is Detection Mode?
What does the 10 KB minimum mean?
What does the 10 KB minimum mean?
How much does a typical review cost?
How much does a typical review cost?
Do force-pushes or rebases trigger a new review?
Do force-pushes or rebases trigger a new review?
Per-Repo Code Review Controls
Configure in Settings → Repos. Learn more about repo settings.authors, labels, or targets filter follows that filter instead of the repo-level skip on that axis.On-Demand Reviews
Even if automatic Code Review is off for a repo, you can always invoke a review manually by commenting@macroscope-app review on any PR in GitHub.
Excluding Files from Code Review
You can exclude specific files from review using a.macroscope/ignore.md file. See .macroscope/ignore.md for details.
Status
Status is powered by per-commit summarization. This feeds your dashboards, weekly digests, productivity metrics, and sprint reports.How is Status different from Code Review?
How is Status different from Code Review?
What triggers a commit charge?
What triggers a commit charge?
- Commits pushed while your balance is exhausted or spend limit is hit (skipped)
- Commits on repos with Status disabled
What happens if I disable Status for a repo?
What happens if I disable Status for a repo?
Common Questions
How is this different from per-seat pricing?
How is this different from per-seat pricing?
Do you have a free trial?
Do you have a free trial?
Annual Discounts
If you’re interested in discounted rates, reach out and we can discuss options for annual commitments. Contact enterprise@macroscope.com.Questions? Email support@macroscope.com or reach out in your shared Slack channel.