tribune-agent 0.1.0a1

AI code/PR review agent. Fetches a pull request, asks an LLM to review it, posts inline comments + summary verdict back to the VCS. Self-hosted, multi-VCS (GitHub, GitLab, Bitbucket, Azure DevOps), multi-LLM (Anthropic / OpenAI / Google / Claude Code / Ollama). Standalone: no inter-package runtime deps.

Tribune

AI code/PR review agent. Fetches a pull request, asks an LLM to review it, posts inline comments + a verdict back to the VCS.

Status: alpha, live on PyPI as tribune-agent==0.1.0a1. Standalone: no inter-package runtime deps. GitHub + GitLab fully implemented in 0.1.0a1; Bitbucket lands in 0.1.0a2; Azure DevOps in 0.1.0a3.

What it does

tribune review https://github.com/owner/repo/pull/42

Tribune fetches the PR, asks your LLM to review the diff, then posts:

• Inline comments anchored to specific file + line, tagged severity (blocker / warning / nit) and category (bug / security / performance / test / style / docs / design).
• A top-level summary with a verdict (approve / request_changes / comment-only).

You can also run --no-post to print the review to your terminal without touching the PR.

Why this exists

ThinkNext ships an OSS agentic SDLC stack:

Stage	Tool
Idea to code	Cascade (human-gated) or Relay (autonomous)
Code to review	Tribune (this repo)
Code to tested running app	Sentinel

Tribune is the only piece that touches every PR, regardless of who wrote it. Human, Cascade, Relay, Copilot, anything else.

Install

pip install 'tribune-agent[anthropic]'        # or [openai], [google], [claude-code], [all]

Configure

# LLM provider
tribune configure llm claude_code --set-default
# Or use a key-based provider:
tribune configure llm anthropic --key sk-ant-xxx --set-default

# VCS provider (token needs PR read + comment write scopes)
tribune configure vcs github --token ghp_xxx --set-default

Credentials live at ~/.config/tribune/config.yaml (mode 0600).

Run

# Print the review without posting (useful for dogfooding):
tribune review https://github.com/owner/repo/pull/42 --no-post

# Post the review back to the PR:
tribune review https://github.com/owner/repo/pull/42

What ships in 0.1.0a1

Capability	Status
GitHub PRs (read + inline comments + review)	Full
GitLab MRs (read + discussions + approve)	Full
Bitbucket PRs	Stub (lands in 0.1.0a2)
Azure DevOps Repos PRs	Stub (lands in 0.1.0a3)
Multi-LLM via vendored client (Anthropic / OpenAI / Google / Claude Code / Ollama)	Full
Diff chunking for large PRs	Full
Skip lockfiles, removed files, binaries	Full
Structured findings (severity + category + line anchor + optional suggestion)	Full
GitHub Actions / GitLab CI / Bitbucket Pipelines / Azure Pipelines wrappers	Planned 0.1.0a2
Per-repo tribune.yaml (rules to apply, paths to skip, custom prompt)	Planned 0.1.0a2

How it differs from existing tools

	CodeRabbit / Greptile	GitHub Copilot review	Tribune
Multi-VCS (GitHub + GitLab + Bitbucket + Azure)	Limited	GitHub only	Yes
Self-hosted (your code stays on your network)	No	No	Yes
Bring your own LLM key	No	No	Yes
Free for individuals	Partial	Subscription	Yes
Open source	No	No	Yes

License

MIT. See LICENSE.

About

Built and maintained by ThinkNext Software Solutions, alongside Cascade, Relay, and Sentinel.