Aptu

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 (Devstral, Llama 3.3, Qwen) do the job with fewer tokens and surprising precision.

Demo

Features

• 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
• Multiple Providers - Gemini (default), Cerebras, Groq, OpenRouter, Z.AI, and ZenMux
• Local History - Track your contributions offline
• Multiple Outputs - Text, JSON, YAML, and Markdown

Installation

# 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-cli

Quick Start

aptu 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 contributions

GitHub Action

Auto-triage new issues with AI using any supported provider.

- uses: clouatre-labs/aptu@v0
  with:
    github-token: ${{ secrets.GITHUB_TOKEN }}
    gemini-api-key: ${{ secrets.GEMINI_API_KEY }}

Options: apply-labels, no-comment, skip-labeled, dry-run, model, provider.

See docs/GITHUB_ACTION.md for setup and examples.

Configuration

See docs/CONFIGURATION.md for AI provider setup.

Security

• 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.

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

License

Apache-2.0. See LICENSE.