Cleanup checks the pages you choose against today's code and the full history of your connected repos, and tells you which ones describe things you removed or never built. It never edits a page: you always decide what to do with its findings.

<aside> ✏ Cleanup is a credit-based add-on and only appears on workspaces where it's turned on. If you don't see Cleanup in the navigation, it isn't enabled for your workspace yet.

</aside>

Before you start

You need at least one connected repo and one destination (a watched Notion page or GitHub docs folder) with pages mapped to it. If you haven't set these up yet, the cleanup screen links you to Go to Repos and Go to Pages to finish that first.

Start a new cleanup

  1. Open Cleanup and select New cleanup.
  2. Choose the pages you want checked, then select Next: repos.
  3. Choose the repos to check those pages against, then select See the estimate.
  4. Review the estimate, which shows how many pages and repos are included and the credits the run will cost. If your team uses its own Anthropic key, the estimate shows the model usage instead, and the run spends no credits.
  5. Select Start cleanup.

The cleanup begins running and appears in your cleanup list with a Progress indicator showing pages done against pages to do.

Cleanup can take some time for large repos or long histories.

Read the report

Open a finished (or in-progress) cleanup to see its report. Each checked page gets one verdict:

Verdict What it means
Probably remove The page describes something the cleanup could not find in the current code or its history.
Keep The page's content still matches something in the repos checked.

The report lists To do and Done counts as the run progresses, and you can filter the page list by verdict. Cleanup only ever reports; it does not change, comment on, or remove anything from the page itself. Acting on a "probably remove" verdict is up to you.

<aside> ✏ If a page's content doesn't match anything in the repos you selected, check that you chose the right repos for that page. A page mapped to the wrong repo will often come back as "probably remove" even when it's accurate.

</aside>

Pause, resume, or cancel a run

While a cleanup is running, you can control it from its detail page: