aptu-cli 0.2.12

CLI for Aptu - Gamified OSS issue triage with AI assistance
aptu-cli-0.2.12 is not a library.

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

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