DeepBlue Dynamics / Docs / Nemesis8 / CLI Reference

CLI Reference

All commands, flags, and subcommands for nemisis8.

Synopsis

nemisis8 [OPTIONS] <COMMAND>
nemisis8 --provider <PROVIDER> interactive
nemisis8 --provider <PROVIDER> site <PROMPT>

Global flags

Flag	Default	Description
--provider <name>	claude	AI provider to use (claude, codex, gemini, ollama, …)
--model <id>	provider default	Override the model for this invocation
--danger	false	Pass provider danger flags (bypass approval prompts)
--session <id>	—	Resume a named session
--verbose	false	Enable debug tracing output

Commands

`interactive`

Launch a container and start an interactive agent session. Attaches your terminal to the agent REPL.

nemisis8 --provider claude interactive
nemisis8 --provider ollama interactive --model qwen3:8b

The container inherits your working directory, MCP tool list, and provider credentials. Session history is saved to ~/.nemesis8/sessions/.

`site <PROMPT>`

Run a one-shot agent task and return. The agent executes, produces output, and the container is torn down.

nemisis8 --provider claude site "summarize the git log for the last week"
nemisis8 --provider codex site "refactor auth.rs to use thiserror"

`build`

Build or rebuild the Docker image for the current provider. Accepts Docker build args to control what gets compiled in.

# Build default image (all providers)
nemisis8 build

# Build with specific providers only
nemisis8 build --build-arg INSTALL_PROVIDERS=claude,codex

# Force full rebuild (no cache)
nemisis8 build --no-cache

`mcp`

Manage MCP (Model Context Protocol) tool servers registered with Nemesis8.

# List registered MCP servers
nemisis8 mcp list

# Add an MCP server
nemisis8 mcp add <name> <command> [args…]

# Remove an MCP server
nemisis8 mcp remove <name>

MCP servers are written to the provider's config directory inside the container at session start. See Docker Environments for the mount layout.

`doctor`

Print a diagnostic summary: config path, Docker availability, registered providers, API key status.

nemisis8 doctor

SCREENSHOT — nemisis8 doctor: docker OK, providers listed, key status

`sessions`

List, inspect, or clean up saved sessions.

# List all sessions
nemisis8 sessions list

# Show details for a session
nemisis8 sessions show <session-id>

# Delete a session
nemisis8 sessions rm <session-id>

`update`

Pull the latest provider CLIs inside the Docker image without doing a full rebuild. Useful after a provider releases a new version.

nemisis8 update

Environment variables

Variable	Description
ANTHROPIC_API_KEY	API key forwarded to Claude sessions
OPENAI_API_KEY	API key forwarded to Codex / OpenAI sessions
GEMINI_API_KEY	API key forwarded to Gemini sessions
NEMESIS8_CONFIG	Override config file path (default: `~/.nemesis8/config.toml`)
NEMESIS8_IMAGE	Override Docker image name/tag