NexusForge CLI

AI-powered development companion for your terminal.

    ███╗   ██╗███████╗██╗  ██╗██╗   ██╗███████╗
    ████╗  ██║██╔════╝╚██╗██╔╝██║   ██║██╔════╝
    ██╔██╗ ██║█████╗   ╚███╔╝ ██║   ██║███████╗
    ██║╚██╗██║██╔══╝   ██╔██╗ ██║   ██║╚════██║
    ██║ ╚████║███████╗██╔╝ ██╗╚██████╔╝███████║
    ╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝
    ███████╗ ██████╗ ██████╗  ██████╗ ███████╗
    ██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔════╝
    █████╗  ██║   ██║██████╔╝██║  ███╗█████╗
    ██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝
    ██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗
    ╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝

Installation

npm install -g nexusforge-cli

Quick Start

# Start NexusForge CLI
nexusforge

# First run will open browser for authentication
# After auth, you're ready to chat!

Features

• Interactive AI Chat - Chat with NexusForge AI directly in your terminal
• Browser Authentication - Secure OAuth-style device authorization flow
• Command Execution - AI can suggest and execute shell commands
• File Operations - Read files into context with /read
• Session Sync - Sync conversations between CLI and web UI
• Slash Commands - Quick actions with /help, /clear, /history, and more

Commands

CLI Arguments

nexusforge                    # Start interactive chat
nexusforge login              # Authenticate with browser
nexusforge logout             # Clear saved credentials
nexusforge status             # Check connection status
nexusforge --session <token>  # Sync with web session
nexusforge --model <name>     # Use specific model
nexusforge --cwd <path>       # Set working directory
nexusforge --version          # Show version
nexusforge --help             # Show help

Slash Commands (in chat)

| Command | Description | |---------|-------------| | /help | Show available commands | | /exit, /quit, /q | Exit CLI | | /clear, /c | Clear screen | | /history | Show conversation history | | /resume [id] | Resume previous conversation | | /model [name] | Get or set the model | | /status | Show connection status | | /read <path> | Read a file into context | | /exec <cmd> | Execute a shell command |

Authentication

On first run, NexusForge CLI uses a secure device authorization flow:

1. CLI displays a verification URL
2. Open the URL in your browser
3. Log in to NexusForge (if not already)
4. Click "Authorize CLI"
5. CLI automatically receives your token

Your credentials are stored securely in ~/.nexusforge/config.json.

Session Sync

Sync conversations between the web UI and CLI:

1. In the web UI, click the Terminal button in the header
2. A command is copied to your clipboard
3. Paste and run in your terminal: nexusforge --session <token>
4. Your web conversation continues in the CLI

Requirements

• Node.js 18+
• NexusForge account (Sign up)

Platform Support

• Linux - Full support
• macOS - Full support
• Windows - Full support (including WSL)

Links

• NexusForge
• AutomataNexus

Copyright 2025 AutomataNexus, LLC. All rights reserved.

This software is proprietary and confidential. Unauthorized copying, distribution, or use is strictly prohibited.