Agent Detective

AI-powered code analysis with plugins for Jira, Linear, and more. Self-hosted, open source, and extensible.

Choose a path

Get started (npm) Five-minute install, init, and mock webhook smoke test.

CLI reference init, doctor, smoke, validate-config — npm operator commands.

Installation paths npm CLI, from source, or bare metal — pick how you run.

Configuration How settings load, env whitelist, and the full config reference.

Build plugins Install and author plugins; use the main API guide when you need depth.

Develop the monorepo pnpm, Turbo, build/test workflow, and optional Cursor agent.

Architecture System shape, layering, and ADRs.

Reference (generated) Zod-generated JSON for bundled plugin options and top-level app config.

Agent harness Boot, verify, lint, smoke, logs — for humans steering coding agents.

Agent workflow Suggested loop before opening a PR; human review expectations.

Golden rules Do / don't for the monorepo; common failures and fixes.

Tool references Short pnpm, Turbo, and ESM pages — low-token entry for agents.

Install Node 24+ and pnpm 10+ (see root package.json packageManager via Corepack).
pnpm install and pnpm run build at the repository root.
Copy config/local.example.json to config/local.json and adjust; read the Configuration hub.
pnpm run dev and open the URL printed in the terminal.