Skip to main content

​
How to Trigger

  1. From GitHub: reply to a Macroscope review comment asking it to fix the issue.
  2. From Slack: ask @Macroscope to fix a bug or make a change.
Fix-it-for-me is not available on cross-repo or fork pull requests. Macroscope will still review these PRs if cross-repo review is enabled, but will not offer fix-it-for-me suggestions.

​
How It Works

  1. Macroscope creates a new branch off the feature branch (if triggered from GitHub) or main (if from Slack).
  2. Macroscope writes the fix and commits it.
  3. Macroscope opens a PR.
  4. Your GitHub Actions run. If any fail, Macroscope attempts to fix them and pushes again.
  5. If auto-merge is enabled, Macroscope merges the PR once all checks pass. PRs against main always require manual merge.

​
Auto-Merge

You can override auto-merge per fix:
  • “Fix it for me and auto-merge”: merges once checks pass, even if auto-merge is off by default.
  • “Fix it but don’t auto-merge”: opens the PR but leaves it for manual merge.
If auto-merge is blocked, Macroscope posts a comment explaining why.

​
Branch Protection

Macroscope never writes directly to main. All branches follow the pattern macroscope/*/**. If you have branch protection rules that apply to all branches, you may need to exclude this pattern.

​
GitHub Actions

Macroscope uses your existing GitHub Actions to validate fixes. To reduce latency or cost, add branch-specific rules for macroscope/*/** to limit which actions run.

​
Generated Code

If your repo has auto-generated code, include the expected diff in your test output. Macroscope will detect and apply it automatically. 
name: Protobuf generated code up-to-date

on:
  push:
  pull_request:

jobs:
  protobuf-gen-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-go@v5
        with:
          go-version: "1.22"
      - name: Install protoc plugins
        run: |
          go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
          go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
      - name: Regenerate protobuf files
        run: protoc -I=proto --go_out=. --go-grpc_out=. proto/*.proto
      - name: Fail if generated files changed
        run: git diff --exit-code