NexoCLI

Your Professional AI Command Line Interface

NexoCLI is a robust and customizable command-line tool designed specifically for the Nexo AI development ecosystem. Built upon the solid foundation of Gemini-CLI by Google LLC, NexoCLI elevates your experience with professional customization, enhanced branding, and seamless integration with the complete Nexo component suite.

🚀 Get Started 📚 View on GitHub 📖 Documentation
npm install -g @nsalvacao/nexo-cli

Quick Start

Get NexoCLI up and running in minutes

1
Install via NPM
# Install globally npm install -g @nsalvacao/nexo-cli
2
Authenticate
# First run - OAuth authentication nexocli "Hello, NexoCLI!" # Browser opens for Google OAuth
3
Start Using
# Interactive mode nexocli # Direct queries nexocli "Explain quantum computing" nexocli "@src/*.js analyze this code"

Why Choose NexoCLI?

Discover the advantages of using NexoCLI for your AI development workflow

🎯

Professional Experience

Enhanced interface with professional branding, improved user experience, and dedicated support for the Nexo ecosystem.

🔒

Independent Authentication

Separate authentication system that doesn't interfere with existing Gemini-CLI installations, ensuring smooth coexistence.

🚀

Hybrid Integration

Designed as part of a comprehensive 4-component AI solution, with planned integration for visual orchestration and unified interfaces.

📦

Easy Distribution

Available on NPM with global installation support, Windows compatibility, and automatic updates.

🔧

Full Compatibility

100% compatible with original Gemini-CLI functionality while adding enhanced features and customizations.

🎨

Customized Interface

Professional ASCII art, English internationalization, and optimized command structure for better usability.

Core Features

Everything you need for professional AI command-line interaction

🎯

Professional Branding

Complete rebranding with custom ASCII art, professional color themes, and enhanced user interface elements.

🔐

Separate Authentication

Independent authentication system using ~/.nexocli/ directory with automatic migration support.

📦

NPM Distribution

Available as @nsalvacao/nexo-cli on NPM with global installation and cross-platform compatibility.

🌍

English Interface

Complete English internationalization with professional terminology and user-friendly help messages.

🔧

Full Compatibility

100% compatible with original Gemini-CLI functionality, maintaining all commands and features.

🚀

Enhanced Performance

Optimized build process with esbuild and streamlined dependencies for faster execution.

Solution Architecture

NexoCLI is part of a comprehensive 4-component hybrid AI solution

Active
🔧

NexoCLI

Professional customization of Gemini-CLI

Command: nexocli

Function: Interface with Google Gemini models

Maintained
🤖

Ollama

Local LLM models execution

Command: ollama

Function: Offline model execution

Planned
🎛️

n8n Orchestrator

Visual agent orchestration

Interface: Web dashboard

Function: Workflow and routing

Planned
🖥️

Unified Interface

Single menu for all agents

Type: Terminal/Web menu

Function: Consolidated UX

Development Roadmap

Our journey towards a complete AI development ecosystem

Phase 1: Professional Branding
✅ Completed

Complete rebranding, NPM publication, authentication separation, and Windows compatibility. Far exceeded original objectives with global distribution.

Phase 2: Custom Commands
🔄 Planned

Implementation of custom slash commands (/nexo info, /nexo status, /nexo config) with ecosystem-specific functionality.

Phase 3: Integration Preparation
🔄 Planned

API endpoints for n8n communication, webhook configuration, and modular settings for hybrid solution integration.

Phase 4: Unified Interface
🔄 Planned

Consolidated menu foundation for multi-agent management and communication protocol implementation.

Phase 5: Orchestration Integration
🔄 Planned

Full n8n orchestration integration with visual workflows and advanced multi-agent coordination.

Usage Examples

Explore different ways to use NexoCLI in your workflow

# Interactive mode nexocli # Direct query nexocli "Explain quantum computing" # Help and version nexocli --help nexocli --version
# Include files in context nexocli "@src/app.js explain this code" # Multiple files nexocli "@src/*.js @docs/README.md review this project"
# Execute shell commands nexocli "!ls -la" nexocli "!npm run test" # Pipe input echo "Hello World" | nexocli
# First run - OAuth authentication nexocli "test authentication" # Browser opens automatically # Credentials stored in ~/.nexocli/

Get Started Today

Choose your preferred installation method

📦

NPM Installation

Install globally via NPM for immediate use across your system

# Install globally npm install -g @nsalvacao/nexo-cli # Use anywhere nexocli "Hello NexoCLI!"
📦 View on NPM
🔧

Development Setup

Clone repository for local development and contribution

# Clone repository git clone https://github.com/nsalvacao/NexoCLI_BaseGemini cd NexoCLI_BaseGemini # Install and build npm install && npm run build # Use locally ./bundle/nexocli.js "Hello!"
🔧 View Repository

Community & Contributions

Join the NexoCLI community and help shape the future of AI CLI tools

🐛

Report Issues

Found a bug or have a feature request? Let us know!

Report Issue
💡

Discussions

Join conversations about features, usage, and ideas.

Start Discussion
🤝

Contribute

Help improve NexoCLI by contributing code or documentation.

Contributing Guide
📚

Documentation

Comprehensive guides and technical documentation.

Read Docs

Legal Attribution

NexoCLI is based on Gemini-CLI by Google LLC and is licensed under the Apache License 2.0.

Original Copyright: 2025 Google LLC
Modifications: 2025 Nuno Salvação
License: Apache License 2.0

All modifications are documented and traceable in the project repository. The original license terms are maintained and respected.