Open source

Get your bearings back in your code.

Source-grounded review, learning, and control for modern codebases. Truth stays canonical. AI helps explain. The human stays in charge.

Get started Read the Handbook

Install

npm install -g @code-bearings/cli

Index

code-bearings analyze

Review

code-bearings review

Features

Every surface shows the same canonical truth.

Source-Grounded

Indexes your TypeScript project into a graph of files, symbols, modules, and dependencies. Every claim has evidence.

Review Intelligence

Generates risk-scored change briefs from any git diff — with symbol explanations, reviewer tips, and contract shift detection.

Five Purpose Modes

General review tells the truth. Bug Hunter, Learning, Architecture, and Exploration modes help humans think with that truth.

VS Code Extension

Hover tooltips, CodeLens, gutter decorations, status bar, and interactive review panels — all fed from the same canonical graph.

CI Ready

Generate review artifacts (Markdown, JSON, HTML) in CI. Optionally fail builds on risk thresholds.

173 Tests

Dogfooded against 5 real repos. Module boundary detection, change briefs, evidence chains — all verified.

Usage

Install

npm install -g @code-bearings/cli

Index your project

code-bearings analyze

Review changes

code-bearings review

# Or compare branches
code-bearings compare main feature-branch

# Or generate CI artifacts
code-bearings ci --fail-on-risk high

Explore the graph

code-bearings modules
code-bearings module auth
code-bearings function generateChangeBrief
code-bearings overview