@adverant-nexus/cli

v3.1.3

Published

2 days ago

World-class CLI for Adverant-Nexus - Surpassing Claude Code and Gemini CLI

0High
0Medium
0Low

adverant

brain nexus cli ai mcp model-context-protocol autonomous-agents multi-agent graphrag microservices devtools

Nexus CLI

Enterprise-Grade CLI for AI-Powered Development

Version: 3.0.0 | Last Updated: December 2024

Why Nexus? • Features • Quick Start • Commands • Architecture • Contributing

Why Nexus CLI?

Most AI CLIs give you a chatbot. Nexus gives you a command center.

Developers often juggle multiple tools, copy context between terminals, and lose track of what each system knows. Nexus CLI was built to unify your AI-powered workflow into a single, coherent interface.

Key Capabilities

| Capability | Description | |------------|-------------| | Auto-Discovery | Automatically detects and integrates 32+ microservices | | MCP Integration | 70+ Model Context Protocol tools exposed as commands | | Multi-Agent Orchestration | Run 10+ concurrent AI agents for complex tasks | | ReAct Agent Mode | Autonomous task execution with up to 20 iterations | | Interactive REPL | Full-featured shell with history and tab completion | | Plugin SDK | Complete extensibility for custom integrations | | Workflow Automation | YAML-based workflows with visual builder | | Real-time Monitoring | Dashboard with alerts and performance metrics | | Cost Tracking | Built-in usage analytics per operation | | Session Management | Save, resume, and checkpoint your work | | Collaboration | Multi-user sessions for team workflows | | Streaming | WebSocket and SSE support for real-time updates |

The Problem We Solve

                    BEFORE: Fragmented Tooling

  Your Terminal --> Tool A    Custom Scripts    Tool B
                       |           |               |
                       v           v               v
                  Context Lost | No Integration | Limited Features

                    AFTER: Unified Command Center

  Your Terminal --> NEXUS CLI
                    - 32+ Services
                    - 70+ MCP Tools
                    - 10+ Agents
                    - Full Context
                         |
        +----------------+----------------+
        v                v                v
    GraphRAG        MageAgent         Gateway

Features

Auto-Discovery & Integration

Stop configuring. Start building.

Automatic service detection from Docker Compose, Kubernetes, and OpenAPI specs
70+ MCP tools exposed through Model Context Protocol integration
32+ microservices accessible through a single CLI
500+ API endpoints auto-generated as commands
Plugin auto-loading from ~/.nexus/plugins/

# Nexus discovers your entire stack automatically
nexus services list
# Output: 32 services discovered, 47 healthy, 0 degraded

nexus mcp tools
# Output: 70 tools available across 12 providers

Intelligent Automation

Your AI that actually gets things done.

Natural language commands: Just describe what you want
ReAct agent mode: 20 autonomous iterations with reasoning
Multi-agent orchestration: Up to 10 concurrent specialized agents
Context-aware execution: Remembers your stack, preferences, and patterns
Workflow templates: YAML-defined automation pipelines

# Natural language - Nexus understands intent
nexus ask "Deploy the latest GraphRAG changes to staging"

# ReAct agent - autonomous problem solving
nexus agent task "Analyze the codebase and suggest performance improvements" --iterations 20

# Multi-agent - parallel specialized work
nexus agent orchestrate --agents "code-review,security-scan,test-coverage"

Extensible Architecture

Build on top of Nexus, don't work around it.

Plugin SDK with full TypeScript support
Hot-reloadable plugins without restart
Permission-based sandbox for security
Custom commands via workspace configuration
MCP protocol support for tool integration

// Create a plugin in minutes
import { NexusPlugin, command } from '@adverant-nexus/sdk';

export default class MyPlugin extends NexusPlugin {
  @command('greet', 'Say hello')
  async greet(name: string) {
    return `Hello, ${name}! Welcome to Nexus.`;
  }
}

Rich Developer Experience

Built by developers, for developers who demand excellence.

Interactive REPL with full history and tab completion
Session checkpointing: Save work, switch contexts, resume later
Multiple output formats: JSON, YAML, Table, Streaming
Git integration: Status, diff, commit from Nexus
Real-time streaming: Watch operations as they happen

# Interactive mode - your AI command center
nexus repl

nexus> services health --all
nexus> agent start research --topic "GraphRAG optimization"
nexus> session save "morning-work"
nexus> exit

# Resume exactly where you left off
nexus session load "morning-work"

Monitoring & Analytics

Know everything. Miss nothing.

Service health dashboard with live updates
Custom alert conditions with webhooks and notifications
Performance metrics per operation
Cost tracking for API operations
Time-series analytics for optimization

# Real-time health monitoring
nexus monitor --dashboard

# Cost analysis
nexus analytics costs --period 30d
# Output: Total: $47.82 | GraphRAG: $23.41 | MageAgent: $18.90 | Other: $5.51

# Performance insights
nexus analytics performance --service graphrag

Quick Start

Installation

# npm (recommended)
npm install -g @adverant-nexus/cli

# yarn
yarn global add @adverant-nexus/cli

# pnpm
pnpm add -g @adverant-nexus/cli

First Run

# 1. Configure your API endpoint
nexus config set services.apiUrl https://your-nexus-api.com

# 2. Authenticate
nexus auth login
# Opens browser for OAuth, or use API key:
nexus auth login --api-key YOUR_API_KEY

# 3. Verify connection
nexus services health

# 4. Explore what's available
nexus --help
nexus services list
nexus mcp tools

Your First Commands

# Ask a natural language question
nexus ask "What services are currently running?"

# Check all service health
nexus services health --all

# Start an interactive session
nexus repl

# Run an autonomous agent task
nexus agent task "Analyze authentication patterns in the codebase"

Command Reference

Core Commands

| Command | Description | |---------|-------------| | nexus auth login | Authenticate with Nexus API | | nexus auth logout | Clear stored credentials | | nexus auth whoami | Show current user info | | nexus config set <key> <value> | Update configuration | | nexus config get <key> | Get configuration value |

Service Commands

| Command | Description | |---------|-------------| | nexus services list | List all discovered services | | nexus services health [--all] | Check service health | | nexus services info <service> | Get detailed service info | | nexus services logs <service> | Stream service logs | | nexus services restart <service> | Restart a service |

Agent Commands

| Command | Description | |---------|-------------| | nexus agent task <description> | Run autonomous agent task | | nexus agent orchestrate | Multi-agent orchestration | | nexus agent status <id> | Check agent task status | | nexus agent list | List running agents | | nexus agent stop <id> | Stop running agent |

MCP Commands

| Command | Description | |---------|-------------| | nexus mcp tools | List available MCP tools | | nexus mcp run <tool> [args] | Execute an MCP tool | | nexus mcp servers | List MCP servers | | nexus mcp status | MCP connection status |

Session Commands

| Command | Description | |---------|-------------| | nexus session save <name> | Save current session | | nexus session load <name> | Load saved session | | nexus session list | List all saved sessions | | nexus session export | Export session to file |

Workflow Commands

| Command | Description | |---------|-------------| | nexus workflow run <file> | Execute workflow from YAML | | nexus workflow create | Interactive workflow builder | | nexus workflow list | List saved workflows | | nexus workflow status <id> | Check workflow status |

Analytics Commands

| Command | Description | |---------|-------------| | nexus analytics costs | View cost breakdown | | nexus analytics usage | View usage statistics | | nexus analytics performance | Performance metrics |

Architecture

+-----------------------------------------------------------------------------+
|                              NEXUS CLI                                       |
+-----------------------------------------------------------------------------+
|                                                                             |
|   +------------------+  +------------------+  +-------------------------+   |
|   |    Commands      |  |      REPL        |  |     Plugin System       |   |
|   |   (60+ cmds)     |  |  (Interactive)   |  |    (SDK + Hooks)        |   |
|   +--------+---------+  +--------+---------+  +------------+------------+   |
|            |                     |                         |                |
|            +---------------------+-------------------------+                |
|                                  |                                          |
|                     +------------v------------+                             |
|                     |     Command Router      |                             |
|                     |  (Discovery + Routing)  |                             |
|                     +------------+------------+                             |
|                                  |                                          |
|            +---------------------+---------------------+                    |
|            |                     |                     |                    |
|     +------v------+       +------v------+       +------v------+            |
|     | HTTP Client |       |  WebSocket  |       |     MCP     |            |
|     |  (REST API) |       | (Streaming) |       |   (Tools)   |            |
|     +------+------+       +------+------+       +------+------+            |
|            |                     |                     |                    |
+------------+---------------------+---------------------+--------------------+
             |                     |                     |
             v                     v                     v
+-----------------------------------------------------------------------------+
|                        NEXUS PLATFORM SERVICES                               |
+-----------------------------------------------------------------------------+
|                                                                             |
|  +-------------+  +-------------+  +-------------+  +-----------------+    |
|  |  GraphRAG   |  |  MageAgent  |  |   Gateway   |  |   32+ More...   |    |
|  |   Memory    |  |   Agents    |  |   Routing   |  |    Services     |    |
|  +-------------+  +-------------+  +-------------+  +-----------------+    |
|                                                                             |
+-----------------------------------------------------------------------------+

Configuration

Environment Variables

# Required
NEXUS_API_URL=https://your-nexus-api.com

# Authentication (choose one)
NEXUS_API_KEY=your_api_key_here
NEXUS_JWT_TOKEN=your_jwt_token_here

# Optional
NEXUS_OUTPUT_FORMAT=json          # json, yaml, table, text
NEXUS_STREAMING=true              # Enable real-time streaming
NEXUS_LOG_LEVEL=info              # debug, info, warn, error
NEXUS_CACHE_ENABLED=true          # Enable response caching
NEXUS_CACHE_TTL=300000            # Cache TTL in ms (5 min)
NEXUS_REQUEST_TIMEOUT=30000       # Request timeout in ms
NEXUS_MAX_RETRIES=3               # Max retry attempts

Configuration Files

Global config: ~/.nexus/config.toml

[services]
api_url = "https://your-nexus-api.com"
timeout = 30000

[auth]
type = "api-key"
api_key = "${NEXUS_API_KEY}"

[output]
format = "json"
color = true
streaming = true

[plugins]
directory = "~/.nexus/plugins"
auto_update = false

Workspace config: .nexus.toml

[project]
name = "my-project"
default_service = "graphrag"

[commands]
# Custom command aliases
deploy = "workflow run ./deploy.yaml"
test = "agent task 'Run all tests and report coverage'"

Plugin Development

Create powerful extensions with the Nexus SDK.

Quick Start

# Create new plugin
npx @adverant-nexus/sdk create my-plugin
cd my-plugin

# Install dependencies
npm install

# Build and link
npm run build
nexus plugin install ./dist

Example Plugin

import {
  NexusPlugin,
  command,
  option,
  PluginContext
} from '@adverant-nexus/sdk';

export default class AnalyticsPlugin extends NexusPlugin {
  name = 'analytics';
  version = '1.0.0';
  description = 'Custom analytics commands';

  @command('report', 'Generate analytics report')
  @option('--period <days>', 'Report period in days', '30')
  @option('--format <type>', 'Output format', 'table')
  async generateReport(ctx: PluginContext) {
    const { period, format } = ctx.options;

    // Access Nexus services
    const analytics = await ctx.services.get('analytics');
    const data = await analytics.getReport({ days: parseInt(period) });

    // Format and return
    return ctx.format(data, format);
  }
}

Contributing

We welcome contributions! Nexus CLI is open source and community-driven.

Getting Started

# Fork and clone
git clone https://github.com/YOUR_USERNAME/Adverant-Nexus-CLI.git
cd Adverant-Nexus-CLI

# Install dependencies
npm install

# Build all packages
npm run build

# Run tests
npm test

# Run in development
npm run dev:cli

Development Guidelines

TypeScript: All code must be TypeScript with strict mode
Testing: Add tests for new features
Commits: Use Conventional Commits
PRs: Include description, tests, and documentation updates

See CONTRIBUTING.md for detailed guidelines.

Documentation

Security

Security is a top priority. See SECURITY.md for:

Reporting vulnerabilities
Security best practices
Credential management

License

MIT License - see LICENSE for details.

Acknowledgments

Built with these amazing open source projects:

Commander.js - CLI framework
Inquirer.js - Interactive prompts
Chalk - Terminal styling
Axios - HTTP client
Zod - Schema validation
MCP SDK - Model Context Protocol

Built with love by Adverant

Website • Documentation • Twitter • Discord

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

Nexus CLI

Why Nexus CLI?

Key Capabilities

The Problem We Solve

Features

Auto-Discovery & Integration

Intelligent Automation

Extensible Architecture

Rich Developer Experience

Monitoring & Analytics

Quick Start

Installation

First Run

Your First Commands

Command Reference

Core Commands

Service Commands

Agent Commands

MCP Commands

Session Commands

Workflow Commands

Analytics Commands

Architecture

Configuration

Environment Variables

Configuration Files

Plugin Development

Quick Start

Example Plugin

Contributing

Getting Started

Development Guidelines

Documentation

Security

License

Acknowledgments