Adverant
Developer Tool

Nexus Cli

Nexus Cli - Adverant Developer Tools documentation.

Adverant Research Team2025-12-083 min read558 words

Development Status: Nexus CLI is currently in active development. Features, metrics (32+ microservices, 500+ endpoints, 70+ MCP tools), and capabilities described represent the planned architecture and design goals. Installation methods and package availability are subject to change during the development phase. For the latest development updates, see the GitHub repository.

Nexus CLI

The Nexus CLI is a world-class command-line interface that provides unified access to the entire Adverant-Nexus platform. With a single installation, you gain access to 32+ microservices, 500+ API endpoints, and 70+ MCP (Model Context Protocol) tools.

Key Features

Unified Platform Access

Access every service in the Adverant-Nexus ecosystem through a consistent, intuitive command structure:

  • 32+ Microservices: GraphRAG, MageAgent, FileProcessAgent, VideoAgent, LearningAgent, and more
  • 500+ API Endpoints: Full REST API coverage with automatic authentication
  • 70+ MCP Tools: Pre-configured Model Context Protocol tools for AI workflows

ReAct Agent Mode

Built-in autonomous agent capabilities with sophisticated reasoning:

Bash
1 line
nexus agent "Analyze the codebase and suggest improvements"
  • Up to 20 reasoning iterations per task
  • Automatic tool selection and chaining
  • Memory persistence across sessions
  • Real-time streaming output

Multi-Agent Orchestration

Coordinate up to 10 specialized agents working in parallel:

Bash
1 line
nexus orchestrate --task "Research and implement feature X" --agents 5
  • Research agents for information gathering
  • Coding agents for implementation
  • Review agents for quality assurance
  • Synthesis agents for summarization

Auto-Discovery

Automatically discovers and integrates with:

  • Docker Compose services
  • Kubernetes deployments
  • Custom MCP servers
  • Local development environments

Plugin SDK

Extend the CLI with custom commands and integrations:

TypeScript
8 lines
import { Plugin, Command } from '@adverant/nexus-cli/sdk'

export class MyPlugin extends Plugin {
  @Command('my-command')
  async myCommand(args: string[]) {
    // Custom logic
  }
}

Installation

Bash
1 line
npm install -g @adverant/nexus-cli

Binary Downloads

Pre-built binaries available for:

  • macOS (ARM64, x64)
  • Windows (x64)
  • Linux (x64, ARM64)

Docker

Bash
1 line
docker run -it adverant/nexus-cli

Quick Start

Bash
14 lines
# Initialize configuration
nexus init

# Connect to Nexus platform
nexus connect --api-key YOUR_API_KEY

# Start interactive REPL
nexus repl

# Run a query with GraphRAG
nexus graphrag query "Find documents about machine learning"

# Execute multi-agent task
nexus orchestrate --task "Summarize project documentation"

Architecture

The Nexus CLI is built with:

  • TypeScript: Full type safety and modern JavaScript features
  • Commander.js: Robust CLI framework with auto-completion
  • WebSocket: Real-time streaming for agent output
  • Plugin System: Extensible architecture for custom commands

Enterprise Features

  • Session Checkpointing: Save and resume long-running tasks
  • Audit Logging: Complete command history and execution traces
  • Role-Based Access: Integrate with enterprise identity providers
  • Offline Mode: Queue commands for later execution