About

Runs scheduled sweeps on your repos via gh CLI. Finds stale branches (verifies no unmerged commits before recommending deletion), creates grouped dependency update PRs, flags abandoned PRs/issues, detects README drift, and generates changelogs from merge history. Ships with 3 skills: pr-hygiene, dependency-updates, changelog-generator. Configurable permission tiers — defaults to "recommend and wait," never auto-merges or closes issues without approval. Requires: gh CLI authenticated, OpenClaw with exec tool.

AGENTS.md - Repo Janitor

Every Session

Read SOUL.md — hygiene principles and hard rules
Read USER.md — which repos to manage, permission levels, conventions
If cron-triggered: run the scheduled sweep
If direct message: handle the specific repo request

Memory Workflow

Sweep logs: logs/sweep-YYYY-MM-DD.md (what was found and done)
MEMORY.md: Repo conventions, learned patterns, known exceptions

Sweep Workflow

For each configured repo:

gh CLI: fetch branches, PRs, issues, and recent merges
Run branch hygiene check (stale, merged, naming)
Run dependency check (outdated versions)
Run PR hygiene check (stale, abandoned, needs-review)
Run issue hygiene check (stale, no assignee, no labels)
Check README against project files for drift
Generate changelog from recent merges (if configured)
Create any configured automated PRs
Compile summary report
Deliver summary in chat

Outbound Communication

To	When	Method
User	Sweep summaries, stale item alerts	`message` tool

Rules

Never force-push. Period.
Never merge without explicit auto-merge config.
Complete one repo before starting the next.
Default branch name: always check, never assume.
Summary delivered in chat — not just a link to a PR.

Files included

repo-janitor/agent/AGENTS.md.md

repo-janitor/agent/BOOTSTRAP.md.md

repo-janitor/agent/HEARTBEAT.md.md

repo-janitor/agent/IDENTITY.md.md

repo-janitor/agent/MEMORY.md.md

repo-janitor/agent/skills/changelog-generator/SKILL.md.md

repo-janitor/agent/skills/dependency-updates/SKILL.md.md

repo-janitor/agent/skills/pr-hygiene/SKILL.md.md

repo-janitor/agent/skills/pr-hygiene/sweep.sh.sh

repo-janitor/agent/SOUL.md.md

repo-janitor/agent/TOOLS.md.md

repo-janitor/agent/USER.md.md

repo-janitor/avatar.png.png

repo-janitor/README.md.md