Okulo documentation

Okulo is a CLI for behavioral code analysis. It mines Git history, estimates complexity, and resolves authorship to show where technical debt is collecting interest.

What it helps you answer

Where is the debt that is actually costing time?
Which parts of the code are getting worse?
Which files are coupled even with no import between them?
Is knowledge concentrated in one person?
Does this PR make the hottest code worse?

Where to start

If you want…	Read
Install and a 5-minute tour	Getting started
Hotspots, health, coupling, bus factor	Concepts
Every command with examples	Commands (submenu per command)
`.okulo.toml`	Configuration
pre-commit, CI, MCP, JSON	Integrations

Install

curl -fsSL https://getokulo.dev/install.sh | sh
okulo --help

Windows (PowerShell): irm https://getokulo.dev/install.ps1 | iex

Okulo prioritizes. Metrics are heuristics for conversation, not verdicts about people. Read Responsible use before sharing social metrics widely.