aptu-core 0.2.4

Core library for Aptu - OSS issue triage with AI assistance
Documentation

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
  • GitHub Action - Auto-triage incoming issues with labels and comments
  • Multiple Providers - Gemini, OpenRouter, Groq, and Cerebras
  • Local History - Track your contributions offline
  • Multiple Outputs - Text, JSON, YAML, and Markdown

Installation

# Homebrew (recommended)
brew tap clouatre-labs/tap
brew install aptu-cli

# Or via cargo-binstall (fast, ~5 seconds)
cargo binstall aptu-cli

# Or from crates.io (~2-3 minutes)
cargo install aptu-cli

# Or build from source
git clone https://github.com/clouatre-labs/aptu.git
cd aptu && cargo build --release

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. Create .github/workflows/triage.yml:

name: Triage New Issues
on:
  issues:
    types: [opened]
jobs:
  triage:
    runs-on: ubuntu-latest
    permissions:
      issues: write
      contents: read
    steps:
      - uses: actions/checkout@v6
      - uses: clouatre-labs/aptu@v0
        with:
          github-token: ${{ secrets.GITHUB_TOKEN }}
          openrouter-api-key: ${{ secrets.OPENROUTER_API_KEY }}
          apply-labels: true  # Apply AI-suggested labels

See docs/GITHUB_ACTION.md for all options.

Configuration

See docs/CONFIGURATION.md for AI provider setup.

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

License

Apache-2.0. See LICENSE.