@zanzojs/cli

The official CLI for ZanzoJS. Scaffolds your project with the correct boilerplate in seconds.

Usage

No installation needed:

npx @zanzojs/cli@latest init    # Scaffold a new project
npx @zanzojs/cli@latest check   # Lint, validate schema AND verify AST complexity

zanzo check — The Security Linter

Beyond basic syntax, check performs advanced static analysis on your schema:

• Circular Dependency Detection: Prevents infinite loops in permission paths.
• AST Complexity Validation: (New) Ensures no permission path generates more than 100 conditional branches. This is crucial for stability in Edge Runtimes (Cloudflare) where CPU limits are strict.
• Dead Code Detection: Identifies unreferenced entities or unused relations.

Or install globally:

pnpm add -g @zanzojs/cli
zanzojs init
zanzojs check

What it generates

• zanzo.config.ts — Your ZanzoJS schema with the entities you specified
• zanzo-migration.sql — The Universal Tuple Table migration for your database
• src/app/api/permissions/route.ts — Snapshot compilation endpoint
• src/app/api/grant/route.ts — Permission grant endpoint with expandTuples
• src/app/api/revoke/route.ts — Permission revoke endpoint with collapseTuples
• .cursorrules / CLAUDE.md / .windsurfrules — Agent context rules for your IDE

Documentation

ZanzoJS Monorepo