Norix

Repository Intelligence CLI for Node.js Projects

Analyze repositories, discover technology stacks, generate architecture insights, visualize system relationships, detect project health issues, and export machine-readable reports — entirely offline.

Why Norix?

When joining an unfamiliar project, reviewing a codebase, or performing a technical audit, understanding the architecture can take hours.

Norix automates that process.

It scans your repository locally and identifies:

• Frameworks
• Databases
• ORMs
• Validation libraries
• Authentication
• Queues
• Storage
• Email providers
• Payment providers
• Build tools
• Infrastructure
• Testing frameworks
• Package managers
• Monorepo tooling
• CI/CD platforms
• Deployment platforms

No source code leaves your machine.

No AI APIs.

No telemetry.

No configuration required.

Features

• Stack detection across 150+ technologies
• AI-ready architecture insights
• Interactive architecture graphs
• Repository health diagnostics
• Plugin system for custom detectors
• Monorepo support
• Offline analysis
• Multiple export formats
• Performance benchmarking
• Zero external services

Installation

npm install -g norix-cli

or

pnpm add -g norix-cli

or

yarn global add norix-cli

Quick Start

Analyze repository

norix analyze

Architecture insights

norix insights

Architecture graph

norix graph

Health report

norix doctor

Generate documentation

norix report

Loaded plugins

norix plugins

Commands

| Command | Description | | -------- | --------------------------- | | analyze | Detect technologies | | insights | Architecture analysis | | graph | Architecture visualization | | doctor | Detect conflicts and issues | | report | Generate documentation | | plugins | Show installed plugins |

Analyze

norix analyze

Detects:

• Frameworks
• Databases
• ORMs
• Validation
• Authentication
• Cache
• Queue
• Storage
• Email
• Payments
• Logging
• HTTP Clients
• Build Tools
• Testing
• CI/CD
• Deployment

Insights

norix insights

Produces:

• Project archetype
• Strengths
• Architectural risks
• Recommendations
• AI-ready JSON
• Markdown report

Graph

norix graph

Formats

norix graph --format tree
norix graph --format mermaid
norix graph --format json

Example

Repository
├── Frontend
│   ├── React
│   └── Next.js
├── Backend
│   └── NestJS
├── ORM
│   └── Prisma
└── Database
    └── PostgreSQL

Doctor

norix doctor

Detects

• Duplicate libraries
• Competing frameworks
• Multiple HTTP clients
• Multiple loggers
• Capability conflicts

Report

norix report

Exports

• Markdown
• JSON

Output Formats

Analyze

norix analyze --format summary
norix analyze --format json
norix analyze --format yaml
norix analyze --format markdown
norix analyze --format csv
norix analyze --format sarif

Graph

tree
mermaid
json

Insights

text
json
markdown

Plugin System

Norix supports third-party detector plugins.

Example

{
  "plugins": ["./plugins/flutter-plugin", "@company/custom-plugin"]
}

List installed plugins

norix plugins

Supported Technologies

Frontend

• React
• Next.js
• Vue
• Angular
• SvelteKit
• Astro
• Remix
• Vite

Backend

• Express
• NestJS
• Fastify
• Hono
• Elysia

Databases

• PostgreSQL
• MySQL
• MongoDB
• SQLite
• Supabase
• Neon
• Turso

ORM

• Prisma
• Drizzle
• TypeORM
• Sequelize
• Mongoose
• Kysely

Testing

• Vitest
• Jest
• Playwright
• Cypress
• Mocha

...and many more.

Performance

Norix includes a benchmarking suite.

npm run benchmark

Measures

• Scan time
• Engine execution
• Cache hit rate
• Memory usage
• Detector performance

Development

git clone https://github.com/sreeragpariyarath/norix.git

cd norix

npm install

npm run build

npm run ci

Roadmap

Upcoming

• HTML reports
• SVG architecture diagrams
• AI explanation engine
• Security rule packs
• Custom reporting plugins
• Dependency timelines

Contributing

Contributions are welcome.

git checkout -b feature/my-feature

git commit -m "feat: add awesome feature"

git push

Open a Pull Request.

License

MIT