NgGenius CLI 🚀

Production-grade, offline AI-powered engineering assistant tailored for enterprise Angular workspaces.

💻 Installation & Usage

npm install -g ng-genius

After installing, use the command in this form:

ng-genius <command> [options]

Run ng-genius --help to see the full command list, or ng-genius <command> --help to inspect one command family.

Command Overview

NgGenius has two command layers:

• Installed CLI commands, such as ng-genius init or ng-genius generate.
• Interactive REPL slash commands, such as /run or /doctor, available after ng-genius repl.

Installed CLI Commands

Project Setup and Configuration

ng-genius init
ng-genius config show
ng-genius config get <key>
ng-genius config set <key> <value>
ng-genius config reset
ng-genius model list
ng-genius model current
ng-genius model use <modelName>
ng-genius provider list
ng-genius provider current
ng-genius provider use <providerName>
ng-genius memory show
ng-genius memory export -o <file>
ng-genius history

Use these commands to initialize a workspace, inspect or change settings, switch the active AI model or provider, and review saved project memory or execution history.

Analysis and Planning

ng-genius analyze
ng-genius plan <request>
ng-genius architect <request>

Use these commands to inspect an Angular workspace, break a request into an execution plan, or produce an architecture blueprint without generating code.

Generation and Execution

ng-genius generate <request>
ng-genius review <request>
ng-genius execute <request>
ng-genius validate
ng-genius run <request> [-y|--yes] [--json]
ng-genius agent <request> [-y|--yes] [--json]
ng-genius workflow [request] [--json]
ng-genius workflows [--json]

Use these commands to generate Angular code, review it, execute workspace changes, validate the workspace, or run the full autonomous workflow pipeline from a single prompt. agent is an alias for run.

Semantic Search and RAG

ng-genius index
ng-genius search <query>
ng-genius context <query>
ng-genius rag index
ng-genius rag search <query> [-k <number>]
ng-genius rag stats
ng-genius rag rebuild

Use these commands to build the semantic index, search the workspace, or retrieve relevant context for a prompt. The top-level index, search, and context commands are shortcuts for the same RAG workflow.

Diagnostics and Performance

ng-genius doctor
ng-genius benchmark
ng-genius metrics
ng-genius logs [-n <count>]
ng-genius health

Use these commands to inspect readiness, benchmark analysis speed, view runtime metrics, read recent logs, and run subsystem health checks.

Git, Release, and Plugins

ng-genius git
ng-genius release
ng-genius plugin list
ng-genius plugin install <name>
ng-genius plugin uninstall <id>
ng-genius plugin update <id>
ng-genius plugin enable <id>
ng-genius plugin disable <id>
ng-genius plugin info <id>

Use these commands to manage Git workflows, prepare releases, and install or administer NgGenius plugins. plugin also accepts the alias plugins.

Utility Commands

ng-genius version
ng-genius repl

Use version to print the current release and repl to start the interactive shell.

REPL Commands

Start the interactive session with:

ng-genius repl

Inside the REPL, commands start with /.

/help
/run <request>
/agent <request>
/architect <request>
/generate <request>
/review <request>
/execute <request>
/validate
/doctor
/benchmark
/metrics
/logs
/health
/rag <query>
/clear
/history
/status
/context
/models
/config
/exit

Use /run or /agent for the full autonomous pipeline, /rag to search the workspace semantically, /doctor and /health to check system readiness, and /status or /context to inspect the current session state.

Common Examples

ng-genius init
ng-genius analyze
ng-genius plan "Add a user profile component"
ng-genius architect "Create a feature module for authentication"
ng-genius generate "Create a standalone Angular dashboard"
ng-genius review "Review the generated dashboard code"
ng-genius validate
ng-genius doctor
ng-genius benchmark
ng-genius search "authentication service"
ng-genius plugin list
ng-genius repl

Example REPL session:

ng-genius repl
/run Add a settings page with a form and validation
/doctor
/rag AuthService
/exit