aptu-cli 0.2.22

CLI for Aptu - Gamified OSS issue triage with AI assistance
aptu-cli-0.2.22 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 do the job with fewer tokens and surprising precision.

Demo

Aptu Demo

Why It Works

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

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
  • Prompt Customization - Override built-in system prompts per operation or append custom guidance via config
  • 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 - OpenRouter (default), Gemini, Groq, Cerebras, Z.AI, and ZenMux
  • Local History - Track your contributions offline
  • Multiple Outputs - Text, JSON, YAML, Markdown, and SARIF

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

MCP Server (hosted, read-only): https://aptu-mcp.fly.dev/mcp - no install required for AI assistant integrations.

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

Security Scanning

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

See docs/SECURITY_SCANNING.md for SARIF upload and GitHub integration.

Prompt Customization

Aptu's built-in system prompts are compiled into the binary as defaults. You can override them per operation at runtime or append project-specific guidance globally.

See docs/CONFIGURATION.md for file paths, operation names, and examples.

GitHub Action

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.

MCP Server

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.

Configuration

See docs/CONFIGURATION.md for AI provider setup.

Models

Use aptu models list to discover available models from all configured providers.

Discovering models

aptu models list                                # all providers
aptu models list --provider openrouter          # OpenRouter only

Filtering and sorting

Flag Description
--provider Filter to a specific provider
--sort name|context Sort by name or context window size
--min-context N Show only models with at least N tokens of context
--filter TEXT Filter by name or ID (case-insensitive substring match)

Free-tier models

OpenRouter exposes pricing data for each model. Models with zero prompt and completion cost are labeled free in the output. Use --provider openrouter to browse free models.

Security

  • OpenSSF Best Practices Silver - Fewer than 1% of open source projects reach this level
  • 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.

Architecture

Aptu is a multi-crate Rust workspace. See docs/ARCHITECTURE.md for the full crate structure, data flow, and key dependencies.

Roadmap

See docs/ROADMAP.md for the project direction across near-term, medium-term, and long-term horizons.

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines. See docs/REPO-STANDARDS.md for a full artifact map and rationale covering CI workflows, tooling, and security controls.

License

Apache-2.0. See LICENSE.