Ren is a local-first CLI that reviews a repository and produces a structured code quality report. It behaves like a lightweight staff engineer pass over an existing codebase: it inspects the filesystem, detects the stack, runs deterministic reviewers, prints a terminal summary, and saves a JSON report.
Ren currently reviews repositories across five areas:
- Architecture: large folders and large source files
- Maintainability: large files, repeated file names, and TODO-style markers
- Documentation: README, setup guidance, and environment configuration notes
- Security: obvious hardcoded secret patterns
- Performance: dependency and bundle-related signals
Findings are conservative by default. The goal is useful signal, not noisy lint output.
From this repository, run Ren against any local project:
npx tsx src/index.ts review /path/to/projectExample:
npx tsx src/index.ts review .Ren prints a summary and writes the full report to:
.ren/reports/review.jsonnpx tsx src/index.ts review /path/to/projectRuns the full deterministic review pipeline and saves a JSON report in the target repository.
npx tsx src/index.ts stack /path/to/projectDisplays detected languages, frameworks, runtimes, package managers, and tools.
npx tsx src/index.ts report /path/to/projectReads .ren/reports/review.json from the target repository and prints the saved summary without running reviewers again.
Each finding includes:
{
id: string;
title: string;
category: string;
severity: 'critical' | 'high' | 'medium' | 'low';
confidence: 'high' | 'medium' | 'low';
evidence: string;
recommendation: string;
}Install dependencies:
npm installTypecheck:
npx tsc --noEmitRun the CLI during development:
npx tsx src/index.ts review .
npx tsx src/index.ts stack .
npx tsx src/index.ts report .Build:
npm run buildThe first milestone is a useful local command:
ren review .