CLI Commands

Complete reference for all NexusCore CLI commands.

nexus-cli chat

Start an interactive agent session.

nexus-cli chat [options]

Option	Description
--model <name>	Override the default model for this session
--no-tools	Disable tool use (Q&A only)
--memory	Enable persistent memory for this session
--swarm	Enable swarm mode for parallel sub-agents
--max-steps <n>	Maximum tool calls per turn (default: 25)

Example:

nexus-cli chat --model codellama:13b --memory

Type exit or press Ctrl+C to end the session.

nexus-cli run

Execute a one-shot agent task.

nexus-cli run "<task description>" [options]

Option	Description
--model <name>	Override the default model
--output <path>	Write output to a file
--quiet	Suppress intermediate output
--no-tools	Disable tool use
--max-steps <n>	Maximum tool calls (default: 25)

Examples:

nexus-cli run "Create a Python hello world script"
nexus-cli run "Refactor the auth module" --model gpt-4o
nexus-cli run "Summarize this codebase" --output summary.md

Account Commands

nexus-cli auth login

Sign in to Nexus Suite using the Device Code Flow.

nexus-cli auth login

Sign in to Nexus Suite

  Open this URL in your browser:
  https://nexus-suite.dev/device

  Enter this code: ABCD-1234

  Waiting for authorization...
  ✓ Signed in as user@example.com (Pro)

The refresh token is stored at ~/.nexuscore/credentials with mode 0600.

nexus-cli auth logout

Sign out and revoke the current session.

nexus-cli auth logout

Deletes local credentials and notifies the API to revoke the session.

nexus-cli auth status

Display current authentication state.

nexus-cli auth status

Signed in as user@example.com
Tier: Pro
Trial: expired
Manage your account at https://nexus-suite.dev/account

When not signed in:

Not signed in. Core tier features are available.
Sign in with: nexus-cli auth login
Upgrade at: https://nexus-suite.dev/pricing

Model Commands

nexus-cli models list

List all configured providers and their available models.

nexus-cli models list

Providers:
  ollama (localhost:11434) — connected
    • llama3.1:8b (default)
    • codellama:13b
  openai (api.openai.com) — connected
    • gpt-4o
    • gpt-4o-mini

When no providers are configured:

No model providers configured.
Run `nexus-cli models detect` to find local servers
or `nexus-cli models add` to configure one manually.

nexus-cli models add

Add a new model provider.

nexus-cli models add <name> --endpoint <url> [--api-key <key>]

Option	Required	Description
--endpoint <url>	Yes	Provider API endpoint URL
--api-key <key>	No	API key (for cloud providers)

Examples:

nexus-cli models add ollama --endpoint http://localhost:11434
nexus-cli models add openai --endpoint https://api.openai.com/v1 --api-key sk-...
nexus-cli models add lmstudio --endpoint http://localhost:1234/v1

nexus-cli models remove

Remove a configured provider.

nexus-cli models remove <name>

nexus-cli models default

Set the default model.

nexus-cli models default <model-name>

nexus-cli models detect

Auto-detect local model servers on common ports.

nexus-cli models detect

Scanning local endpoints...
  ✓ Ollama detected on localhost:11434 (3 models available)
  ✗ LM Studio not detected on localhost:1234
  ✗ No server on localhost:8080
  ✗ No server on localhost:5000

Add detected providers? [Y/n]

Skills Commands

nexus-cli skills create <name>

Scaffold a new skill in .nexuscore/skills/.

nexus-cli skills create my-skill

nexus-cli skills install <name>

Install a skill from the Skills Hub.

nexus-cli skills install code-reviewer

nexus-cli skills remove <name>

Remove an installed skill.

nexus-cli skills remove code-reviewer

nexus-cli skills list

List installed skills with their status.

nexus-cli skills list

nexus-cli skills search <query>

Search the Skills Hub for skills.

nexus-cli skills search "code review"

nexus-cli skills publish <name>

Publish a skill to the Skills Hub (Pro tier required).

nexus-cli skills publish my-skill [--visibility public|private|org]

nexus-cli skills update <name>

Update an installed skill to the latest version.

nexus-cli skills update code-reviewer

nexus-cli skills activate <name> / deactivate <name>

Activate or deactivate an installed skill.

nexus-cli skills activate code-reviewer
nexus-cli skills deactivate code-reviewer

nexus-cli skills test <name>

Test a skill in a sandbox session.

nexus-cli skills test my-skill

Tool Commands

nexus-cli tools list

List all available tools.

nexus-cli tools list

MCP Commands

nexus-cli mcp list

List connected MCP servers.

nexus-cli mcp list

nexus-cli mcp add

Add an MCP server connection.

nexus-cli mcp add <name> --transport <stdio|sse> --command "<command>"

nexus-cli mcp remove

Remove an MCP server connection.

nexus-cli mcp remove <name>

Sync Commands

nexus-cli sync status

Check sync status and quota usage (Pro tier required).

nexus-cli sync status

nexus-cli sync push

Push local data to the sync service.

nexus-cli sync push [--namespace settings|skills|memory]

nexus-cli sync pull

Pull data from the sync service.

nexus-cli sync pull [--namespace settings|skills|memory]

Telegram Commands

nexus-cli telegram pair

Start the Telegram pairing flow.

nexus-cli telegram pair

nexus-cli telegram status

Check Telegram bridge connection status.

nexus-cli telegram status

nexus-cli telegram revoke

Revoke the active Telegram session.

nexus-cli telegram revoke

nexus-cli telegram config

Configure Telegram bridge settings.

nexus-cli telegram config --allow-tools file_read,file_list,text_search

nexus-cli update

Check for and install the latest version of NexusCore CLI.

nexus-cli update

Current version: 1.0.0
Latest version:  1.1.0

Update available! Install now? [Y/n]

nexus-cli status

Show the overall status of NexusCore (running processes, active connections).

nexus-cli status