startriage

Unified triage tool for Ubuntu

• Launchpad
• GitHub
• Discourse
• Proposed migration

Installation

snap install startriage
# or clone this git repo, then run with:
uv run startriage

Quick Start

# Daily triage (yesterday's activity, or Friday–Sunday if today is Monday)
startriage triage
# Generate a markdown report as template for discourse alongside
# (remember /tmp/ is private when running as snap)
startriage triage --markdown ~/triage-summary.md

# Specify a team explicitly
startriage -t ubuntu-server triage

# Use a subset of sources
startriage -s discourse,github triage

# Changes on a specific day or range
startriage triage -i monday
startriage triage -i yesterday:  # changes since yesterday
startriage triage -i 2026-04-14
startriage triage -i 2026-04-14:2026-04-18  # range is inclusive

# Housekeeping: server-todo tagged bugs with assignees
startriage todo

# Subscription backlog (ubuntu-server subscribed bugs)
startriage todo --subscribed

Triage Options

Option	Description
-t --team TEAM	Select a configured team
-i --interval DATE[:DATE]	Include changes from this day or range (YYYY-MM-DD, day name, or yesterday)
-s --source SOURCE	Restrict to one source: launchpad, discourse, github
--update {theirs,ours,all}	Filter bugs by who last updated them
--flag-recent DAYS	Mark bugs updated within N days with U flag
--flag-old DAYS	Mark bugs inactive for more than N days with O flag
--open -o	Open results in the web browser
--fullurls	Print full URLs instead of terminal hyperlinks
--markdown PATH	Write parallel markdown output (for pasting into Discourse posts)

Run startriage triage --help for the full option reference, including the bug flags legend.

AI Triage (experimental)

Inspect one or more Launchpad bugs, optionally running an AI agent over them. By default analyze prints the bug metadata (status, tags, affected targets, description, comments) so you can eyeball it — no provider or credentials required. Add --ai to run the agent, which produces a suggested status, tags, analysis, and (where applicable) a proposed fix. The agent never edits bugs and never applies patches — it only prints its analysis.

--ai requires a permission level that controls what the agent may run:

• restricted — no tool execution; the agent reasons only over the bug metadata it was handed.
• full — auto-approve every shell/file/web tool the agent requests. This lets it pull source, run debdiff, fetch upstream, etc., but it executes arbitrary commands on your host: only use it in a container or throwaway environment.
• ask — the agent runs tools, but you are prompted on the terminal to approve or deny each call.

# Show metadata for one or more specific bugs (URL, NNNNNN, or #NNNNNN)
startriage analyze 2101234 '#2105678'

# Run the AI agent over those bugs, text-only reasoning (restricted)
startriage analyze --ai restricted 2101234 '#2105678'

# Let the agent run tools, approving each one interactively
startriage analyze --ai ask 2101234

# Run the normal daily triage, then AI-triage every bug found (auto-approve tools)
startriage triage --ai full

Warning: --ai full auto-approves tool execution with no confirmation. Run it only inside a container or otherwise isolated environment. Containerized agent execution is planned as future work (see issue #4).

The AI output is printed after the normal triage results. With --markdown FILE the AI section is folded into that same report file (behind a clear "review critically" notice) so you get a single cohesive document.

Configure a provider first (credentials are written to the 0600 config, never echoed):

# Default provider: GitHub Copilot (needs a Copilot-enabled account)
startriage config set --ai-provider copilot --ai-github-token github_pat_...

# Or bring your own key via an OpenAI-compatible provider (e.g. OpenRouter)
startriage config set --ai-provider openrouter \
    --ai-model anthropic/claude-opus-4.1 \
    --ai-openrouter-key sk-or-...

The Copilot token may also come from COPILOT_GITHUB_TOKEN / GH_TOKEN / GITHUB_TOKEN, and the OpenRouter key from OPENROUTER_API_KEY. The snap bundles the Copilot runtime and ubuntu-dev-tools, so source analysis works inside strict confinement; from a git checkout install the extra with uv sync --extra ai.

Configuration

adjust the defaults with your user configuration file:

• for the snap: ~/snap/startriage/current/.config/startriage.toml
• otherwise: ~/.config/startriage.toml

[general]
lp_triage_updates = "theirs"   # theirs | ours | all
default_team = "ubuntu-server"
savebugs_dir = "~/your-path-to-persisting-bug-progress"

[team.ubuntu-server]
lp_team = "ubuntu-server"
lp_todo_tag = "server-todo"
lp_ignore_packages = ["linux", "linux-meta"]
discourse_categories = ["project/server"]
discourse_triage_categories = ["project/server/server-triage"]  # suppress triage-post main entries; show replies only
github_repos = ["canonical/ubuntu-server-documentation"]
proposed_migration_teams = ["ubuntu-server"]

# other team definitions

Persist common settings without editing the file by hand:

startriage config show
startriage config set --default-team ubuntu-server

Save / Compare Bug Lists

# Auto-save and auto-compare (uses the most recent file in startriage.toml general.savebugs_dir)
startriage todo

# specify directory to save/compare todo-$(date) files with current bugs (override for general.savebugs_dir)
startriage todo --save-bugs-dir ~/savebugs

# Save today's todo list
startriage todo -S ~/savebugs/todo-$(date -I).yaml

# Compare against a previous save to spot new and closed bugs
startriage todo -C ~/savebugs/todo-2026-04-01.yaml