What it is
A repository-aware maintainer assistant for GitHub projects. co-maintainer
analyzes a repository's code, workflows, commits, pull requests, discussions, and diffs to
generate contribution guidance and surface likely review issues before human review.
The problem
Repository-specific contribution rules, review expectations, testing requirements, and
workflows are difficult to discover and apply consistently. Generic coding rules miss the
conventions that make a particular codebase maintainable.
Key decisions
Repository-aware analysis — guidance is derived from the project's own code,
workflows, history, pull requests, and review discussions.
Low/high model separation — extraction and synthesis use different model
paths so repository analysis can stay focused and composable.
Incremental cache — SQLite tracks codebase and PR revisions, avoiding
unnecessary reprocessing while keeping later reviews current.
Technical implementation
| Component | Technology | Purpose |
| Runtime | Deno · TypeScript | Modular CLI and analysis pipeline |
| GitHub access | GitHub CLI · PAT | Repository, commit, PR, discussion, and diff data |
| AI providers | OpenRouter · Hetzner AI | Provider abstraction for extraction and synthesis |
| Cache | SQLite | Incremental codebase and PR revision tracking |
| Distribution | JSR | Publishable Deno package and CLI |
Workflow
The CLI collects repository context, extracts patterns and expectations, synthesizes a
repository-specific SKILL.md,
and can use that guidance to review an individual pull request. Optional review guides,
improvement passes, and detailed token, cost, timing, heartbeat, and debug logs make the
process inspectable.
Current result
78s
PR review
9.5K
input tokens
7.6K
output tokens
$0.0115
review cost
A second-pass review used approximately 38.9K input tokens, 11.4K output tokens, and cost
$0.0234.
Next evaluation area
The CLI has reached a working stage and produces actionable pre-review findings. The main
remaining evaluation area is measuring finding accuracy with feedback from engineers familiar
with the target codebase.