Skip to content

Repository files navigation

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.

npm version npm downloads license


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

About

Offline repository intelligence CLI for detecting technologies, generating architecture insights, visualizing dependency graphs, and auditing Node.js projects.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages