Introduction

Zeno is a local CLI that reviews AI-generated code changes before you merge them. It scans your project, identifies risky boundaries, flags missing verification, and tells you the smallest safe next step.

It is not a coding assistant. It does not write or rewrite code. Zeno is the judgment layer that answers: can I safely review, change, and merge this diff?

What Zeno does

• Produces a ship-readiness report for your current codebase or diff
• Identifies do-not-touch zones (auth, payments, webhooks, data writes)
• Flags broad rewrites that exceed the value of the change
• Recommends the smallest safe improvement over a large refactor
• Runs local security checks for obvious risk signals
• Suggests when to skip a file rather than refactor it

What Zeno does not do

• Write or generate code
• Replace manual code review
• Guarantee correctness
• Replace senior engineering judgment

Requirements

• Node.js 18 or later
• A JavaScript, TypeScript, JSX, or TSX project
• An API key from one of the supported providers

First run

No install required. Run Zeno directly with npx:

npx zenoai

On first run, Zeno will ask you to choose a provider and enter your API key. Your config is saved locally at ~/.zenoai/config.json so you are only prompted once.

After setup, Zeno scans the project, builds a source summary, and prompts you to choose an action.