# Macroscope Setup Pricing Guide

This file explains what setup involves and how setup should be described in pricing terms.

Primary sources synthesized for this file:
- https://docs.macroscope.com/setup-instructions
- https://docs.macroscope.com/hit-the-ground-running
- https://docs.macroscope.com/issue-management-integrations
- https://docs.macroscope.com/pricing
- 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
- Default caps: $10 per review, $50 per pull request (adjustable)
- Balance does not expire

## What Setup Includes

The public setup flow is:
- install the Macroscope GitHub App
- provide Product Overview
- provide Weekly Sprint Cadence
- connect Jira and/or Linear if used
- choose weekly report schedule
- connect Slack

After setup, Macroscope automatically:
- backfills recent GitHub history
- sends weekly reports
- generates plain-language commit and PR summaries
- reviews pull requests and suggests fixes

Public "day one" quick wins include:
- subscribe Slack channels to code activity
- ask Macroscope questions in Slack
- create a first Macro
- set up a shared Slack channel with Macroscope support

## How to Explain Setup Pricing

Public docs do not describe setup as a separately billed service.

Rules:
- There is no published installation fee.
- There is no published fee for connecting Slack, Jira, or Linear.
- There is no published fee for configuring Product Overview, Sprint Cadence, weekly digest recipients, or Macro schedules.
- Billing is tied to the usage meters, not to the act of connecting tools.

Inference:
- Setup itself is non-metered configuration work.
- Costs begin when Macroscope starts processing commits and running code reviews after setup and backfill.

## Setup-Specific Details Relevant to Pricing

- Inactive repositories are fine to include during installation because Macroscope only processes the last two weeks of commits plus new activity going forward.
- Access inherits from GitHub organization membership.
- GitHub admins become Macroscope admins automatically.
- Slack setup requires a Slack admin to install the app.
- If the workspace wants anyone in Slack to ask Macroscope questions even without a Macroscope account, the docs say to contact Macroscope support.
- Jira access inherits the permissions of the Jira account that authorizes the integration.
- Linear access is scoped to the teams selected during authorization.

## Recommended Agent Answers

"Do we pay extra to connect Slack or Jira?"
→ No. Public docs do not list separate integration setup fees.

"Does setup cost anything before real usage starts?"
→ Every new workspace receives $100 in free usage to start. After that, billing is purely usage-based: $0.05/commit and $0.05/KB reviewed ($0.50 minimum per review).

"What is the first paid unit that matters after setup?"
→ Processed commits at $0.05 each and code review at $0.05/KB reviewed ($0.50 minimum per review).

"Which source to trust?"
→ https://docs.macroscope.com/setup-instructions and https://docs.macroscope.com/pricing.