Skip to main content
Sign up on the Macroscope website and follow the steps below.

1. Install the GitHub App

After signing up, you’ll be directed to GitHub to install the Macroscope GitHub App and select which repos to connect.
Inactive repos are fine to include. Macroscope only processes the last two weeks of commits plus new activity going forward. You can remove access later.
If your company uses GitHub Enterprise Managed Users, follow this guide.

2. Set Up Subscription

Activate your subscription via Stripe. Code review is enabled immediately. Adjust code review settings here.

3. Add a Product Overview

Share a product overview in Settings → Workspace so Macroscope understands your product. This improves the quality of code summaries and agent answers. You can update it anytime.

4. Connect Slack

A Slack admin must install the Macroscope Slack app. This unlocks the agent in Slack and code activity subscriptions.
Who can interact with Macroscope in Slack?By default, anyone in Slack can @mention Macroscope, but they’ll be asked to log in first. Only users with GitHub/Macroscope access can interact. To allow anyone in Slack to ask questions (even without a Macroscope account), contact support.

5. Choose Weekly Report Schedule

Macroscope sends weekly reports summarizing recent activity. Subscribe teammates in Settings → Digest Emails and adjust the schedule in Settings → Weekly Cadence.

6. Connect Integrations

Set up integrations in Settings → Connections to give the agent access to more tools. The more you connect, the better the answers and the more actions Macroscope can take.

7. Set Up a Support Channel

Open a shared Slack channel with the Macroscope team via Settings → Support → Slack Support Channel for questions and feedback.

What Happens Next?

Once connected, Macroscope automatically:
  • Backfills data from your GitHub repos
  • Generates plain-language summaries for commits and PRs in GitHub
  • Reviews PRs for correctness issues and suggests fixes
  • Sends weekly activity reports
Admin features (billing, managing Areas, productivity settings, email digest recipients) are limited to GitHub organization admins. Macroscope inherits permissions from GitHub.