CLI Reference

CLI Reference

Nebulus Atom provides two command aliases: nebulus-atom and mn (shorthand).

Commands

start

Start the Nebulus Atom AI Agent.

python3 -m nebulus_atom.main start [PROMPT] [--session-id ID]

Argument	Required	Description
PROMPT	No	Initial prompt to execute on startup
--session-id	No	Session identifier (default: "default")

Examples:

# Interactive mode
python3 -m nebulus_atom.main start

# With initial prompt
python3 -m nebulus_atom.main start "fix the login bug in auth.py"

# Named session
python3 -m nebulus_atom.main start --session-id feature-auth

docs

Access embedded documentation.

python3 -m nebulus_atom.main docs <ACTION> [FILENAME]

Argument	Required	Description
ACTION	Yes	list or read
FILENAME	For read	Document filename to display

Examples:

# List available docs
python3 -m nebulus_atom.main docs list

# Read a specific doc
python3 -m nebulus_atom.main docs read features.md

dashboard

Launch the Flight Recorder Dashboard (Streamlit web UI).

python3 -m nebulus_atom.main dashboard

Opens a Streamlit dashboard at http://localhost:8501 showing agent telemetry, tool usage, and session history.

In-Session Commands

While the agent is running, these slash commands are available:

Command	Description
/help	Show available commands
/exit or /quit	Exit the agent
/pin <file>	Pin a file to context
/unpin <file>	Remove a file from context
/context	Show pinned files
/checkpoint	Create a manual checkpoint
/undo	Undo last file change
/skills	List available skills
/tdd <goal>	Start a TDD cycle
/auto	Toggle autonomous mode

Docker Usage

Core Agent

docker compose up agent

Dashboard

docker compose up dashboard

Swarm Mode

docker compose -f docker-compose.swarm.yml up overlord

Environment Variables

Key variables (see Configuration for full list):

Variable	Default	Description
NEBULUS_BASE_URL	http://localhost:5000/v1	LLM server URL
NEBULUS_MODEL	Meta-Llama-3.1-8B-Instruct-exl2-8_0	Model name
NEBULUS_TIMEOUT	300	Request timeout (seconds)
NEBULUS_STREAMING	true	Enable streaming responses

Shorthand

The mn command is an alias for nebulus-atom:

mn start "hello world"
mn docs list
mn dashboard