AI-Powered Triage Utility - A CLI for OSS issue triage with AI assistance.
Aptu is a context-engineering experiment: instead of throwing big models at problems, it crafts tight prompts that let smaller models do the job with fewer tokens and surprising precision.
Aptu uses task specialization over raw model capability:
| Factor | Aptu | General Agent |
|---|---|---|
| Context | Only the diff | Entire conversation + tools |
| Prompt | Tuned for code review patterns | General reasoning |
| Attention | 100% on code quality | Split across many tasks |
The small specialized model is not smarter, just less distracted. In real-world testing, aptu's PR review (using the default openrouter/mistral-small-2603) caught regex-based HTML parsing and missing error handling that claude-opus-4.5 shipped as "done".
- AI Triage - Summaries, suggested labels, clarifying questions, and contributor guidance
- Issue Discovery - Find good-first-issues from curated repositories
- PR Analysis - AI-powered pull request review and feedback
- Release Notes - AI-curated changelogs from merged PRs
- GitHub Action - Auto-triage incoming issues with labels and comments
- MCP Server - Model Context Protocol integration for AI assistants
- Multiple Providers - Groq (default), Cerebras, Gemini, OpenRouter, Z.AI, and ZenMux
- Local History - Track your contributions offline
- Multiple Outputs - Text, JSON, YAML, Markdown, and SARIF
# Homebrew (macOS/Linux)
brew install clouatre-labs/tap/aptu
# Snap (Linux)
snap install aptu
# Cargo-binstall (fast)
cargo binstall aptu-cli
# Cargo
cargo install aptu-cliaptu auth login # Authenticate with GitHub
aptu repo list # List curated repositories
aptu issue list block/goose # Browse issues
aptu issue triage block/goose#123 # Triage with AI
aptu issue triage block/goose#123 --dry-run # Preview
aptu history # View your contributionsAptu includes built-in security pattern detection for PR reviews. Scanning is performed locally, and no code is sent to external services.
aptu pr review owner/repo#123 # Review with security scanning
aptu pr review owner/repo#123 --output sarif # SARIF for GitHub Code ScanningSee docs/SECURITY_SCANNING.md for SARIF upload and GitHub integration.
Auto-triage new issues with AI using any supported provider.
- uses: clouatre-labs/aptu@v0
with:
github-token: ${{ secrets.GITHUB_TOKEN }}
openrouter-api-key: ${{ secrets.OPENROUTER_API_KEY }}Options: apply-labels, no-comment, skip-labeled, dry-run, model, provider.
See docs/GITHUB_ACTION.md for setup and examples.
Integrate aptu with AI tools via the Model Context Protocol (MCP). Supports stdio (goose, Claude Desktop) and HTTP (remote/containerized).
See docs/MCP_SERVER.md for client configuration and Docker deployment.
See docs/CONFIGURATION.md for AI provider setup.
- SLSA Level 3 - Provenance attestations for all releases
- REUSE/SPDX - License compliance for all files
- Signed Commits - GPG-signed commits required
- Dependency Scanning - Automated updates via Renovate
See SECURITY.md for reporting and verification.
We welcome contributions! See CONTRIBUTING.md for guidelines.
Apache-2.0. See LICENSE.