tribunal-install

Install and initialise Tribunal — the Claude Code quality enforcement plugin. Use when setting up a new project for AI-assisted development, when a project lacks TDD enforcement, secret scanning, or Claude Code quality gates, or when asked to "add quality enforcement", "set up tribunal", or "protect this project". Works with pip, uv, npm, and brew.

Tribunal — Install & Initialise

Tribunal enforces code quality when Claude Code writes files: TDD enforcement, secret scanning, context monitoring, Agent Teams quality gates, and a live dashboard.

Install

Python / uv (recommended)

pip install tribunal
# or
uv add tribunal

npm

npm install -g tribunal

Homebrew

brew install thebotclub/tap/tribunal

Verify install:

tribunal --version

Initialise a project

Run in your project root (where .claude/ lives or will live):

tribunal init

The wizard asks:

Primary language (Python / TypeScript / Go / Other)
TDD enforcement level (Strict = block on fail / Advisory = warn / Off)
Secret scanning (On/Off — default On)
Spec workflow (Yes/No — default Yes)
Context monitor (On/Off — default On)

For non-interactive / agent use:

tribunal init --non-interactive --project-dir /path/to/project

Outputs .claude/tribunal.json and merges into .claude/settings.json.

Verify setup

tribunal doctor

Checks all hooks, Python deps, worker service, and .claude/settings.json links. Exits 1 if anything is broken — safe to use in CI.

Quick install + init (one-liner for agents)

pip install tribunal && tribunal init --non-interactive && tribunal doctor

Install a quality pack

tribunal list-packs          # see available packs
tribunal install python-strict
tribunal install go-tdd
tribunal install nextjs-quality

Workflow

Once installed, Tribunal hooks into Claude Code automatically:

Every file Claude writes → file_checker runs (secrets, language quality)
Every test run → tdd_enforcer checks pass/fail
Context usage → context_monitor warns before window fills
Agent Teams → teammate_idle + task_completed gate sub-agent output
Dashboard → tribunal/ui/viewer.html shows live hook feed

Run standalone quality check (no Claude Code needed)

tribunal ci                        # check changed files
tribunal ci --json                 # machine-readable output
tribunal ci --coverage-threshold 80

Troubleshoot

tribunal doctor              # health check with fix suggestions
tribunal status              # show current config + audit summary

Full docs: https://tribunal.dev · GitHub: https://github.com/thebotclub/tribunal