full loop

From app setup to clean doc updates in four moves.

Recommended Flow

Step 1

Connect in the app

Connect your repo, choose included repos, and add any existing Notion or repo docs first.

Step 2

Install the skill

Adds the Sweepr documentation-linking skill to Codex and Claude Code.

npm install -g sweepr-code

Step 3

Sign in once

Stores one local Sweepr session for this machine. Future runs reuse it automatically.

sweepr-code login

Step 4

Run Sweepr

Run from a local checkout. Codex uses `$sweepr`; Claude Code uses `/sweepr`.

$sweepr /sweepr

Other Commands

Check Sweepr files

Checks that Sweepr is ready in the current project.

sweepr-code check

Refresh link note

Writes minimal .sweepr config and context hints for this checkout.

sweepr-code init

Install repo-local assets

Copies Sweepr agent assets into the repository only when that scope is wanted.

sweepr-code repo-install

Diagnose Notion access

Checks auth, workspace, URL parsing, and page sharing for a linked Notion doc.

sweepr-code notion doctor <url-or-page-id>

Append Notion update

Writes a bounded linked-page update through Sweepr's stored Notion auth.

sweepr-code notion update <url-or-page-id> --file update.md --yes

Write optional hook templates

Writes templates under .sweepr/hooks and never modifies .git/hooks.

sweepr-code hooks install