NexusCore CLI Reference

NexusCore is a local-first AI agent runtime for the command line. It provides a full-featured agent with 22 built-in tools, swarm mode, skills, MCP support, and persistent memory — all running locally with your own models.

Installation

pip install nexus-suite

See Installation for all installation methods (Homebrew, install script, pipx).

Usage

nexus-cli [command] [options]

Command Groups

Group	Description
chat	Start an interactive agent session
run	Execute a one-shot agent task
auth	Authentication and account management
models	Configure model providers and routing
skills	Manage agent skills (create, install, publish)
tools	List and configure available tools
mcp	Manage MCP server connections
sync	Manage encrypted sync (Pro tier)
telegram	Telegram remote access
update	Check for and install updates
status	Show NexusCore status

Quick Reference

# Interactive chat
nexus-cli chat

# One-shot task
nexus-cli run "Refactor the auth module"

# Sign in to Nexus Suite
nexus-cli auth login

# Check auth status
nexus-cli auth status

# Auto-detect local model servers
nexus-cli models detect

# List models
nexus-cli models list

# Install a skill
nexus-cli skills install code-reviewer

# Update CLI
nexus-cli update

Sections

• Commands — Full command reference with all options
• Flags & Options — Global flags and environment variables
• Configuration — Config file format and options