# Macroscope Code Review Pricing Guide

This file is written for agent consumers. It explains what the Code Review product does, how it is billed, and how to answer pricing questions without guessing.

Primary sources synthesized for this file:
- https://docs.macroscope.com/pricing
- https://docs.macroscope.com/bug-detection-and-fixes
- https://docs.macroscope.com/pull-request-descriptions
- https://docs.macroscope.com/fix-it-for-me
- https://docs.macroscope.com/approvability
- https://docs.macroscope.com/rules
- https://macroscope.com/#pricing

## Canonical Public Pricing

Macroscope uses fully usage-based pricing:
- Code Review: $0.05 per KB of code reviewed, with a 10KB minimum per review ($0.50 floor)
- Status: $0.05 per processed commit
- Agent: $0.01 per credit (1,000 free credits/month included per workspace)
- Free usage: every new workspace receives $100 in free usage to start
- Enterprise sales contact: enterprise@macroscope.com

Key billing mechanics:
- A single pull request can incur multiple review charges — each new push can trigger another review run.
- Admins can set per-review caps, monthly budget limits, and repo-level toggles in Settings > Billing.
- Default cost caps: $10 per review, $50 per pull request (adjustable in Settings > Billing).

## What Code Review Includes

Macroscope Code Review automatically reviews pull requests for quality and correctness.

Documented capabilities:
- Inline GitHub comments describing issues in plain language with impact explanation.
- Suggested diffs for fixing issues.
- Conversational: engineers can reply to Macroscope comments and react with thumbs up/down.
- Per-repo enable/disable controls, plus workspace defaults for newly linked repos.
- Manual trigger via `@macroscope-app review` in a PR comment.
- PR summaries: written into an empty PR description, posted as a comment if a description exists, or inserted between template markers if present.
- Fix It For Me: creates a branch, commits a fix, opens a PR, and iterates until CI passes.
- Approvability: auto-approves low-risk PRs when both eligibility and correctness pass.
- Custom Rules via `macroscope.md` files (beta): runs a separate best-practices review pass.

## How to Explain Billing for Code Review

"What does code review cost?"
→ $0.05/KB reviewed ($0.50 minimum), plus $0.05 per processed commit.

"How do we estimate a month's code review bill?"
→ Estimate total KB reviewed across all PRs × $0.05/KB (with $0.50 minimum per review), plus processed commits × $0.05.

## Feature-Specific Pricing Interpretations

The public pricing docs publish three usage meters: commits, code review runs, and Agent credits.

Bundled under the Code Review meter (no separate line items):
- PR descriptions
- Approvability
- Custom Rules
- Always-review labels or manual trigger comments

Billed as Agent credits (separate from Code Review):
- Fix It For Me

Inference:
- Treat the bundled items above as Code Review features, not separate SKUs.
- Fix It For Me writes code, so it's an Agent feature and uses Agent credits at $0.01/credit.
- If a feature triggers additional code review runs or commit processing, the standard usage meters still apply.
- No published "per summary", "per approval", or "per rules check" fee exists.

## Operational Details Relevant to Pricing

- Code Review is enabled by default on linked repos but can be disabled per repo.
- Fix It For Me never writes directly to main branches — it creates new branches and PRs.
- Macroscope-generated branches for Fix It For Me follow the `macroscope/*/**` naming pattern.
- Approvability is available to all workspaces but is disabled by default.
- Approvability requires two hurdles:
  - eligibility
  - correctness
- Correctness means the pull request must pass Macroscope Code Review with zero issues.
- Eligibility can use CODEOWNERS, blame history, author role, and optional `.macroscope/approvability.md` rules.

## Recommended Agent Answers

"Is Code Review usage-based or seat-based?"
→ Fully usage-based. Code review is billed at $0.05/KB reviewed ($0.50 minimum per review), and commits at $0.05 each.

"Does Fix It For Me cost extra?"
→ Fix It For Me is an Agent feature, so it's billed as Agent credits at $0.01/credit (1,000 free credits/month per workspace). It's separate from the Code Review meter.

"Do PR summaries cost extra?"
→ No separate fee published.

"Which source to trust?"
→ https://docs.macroscope.com/pricing for billing; the Code Review docs listed above for feature behavior.