The Artemis CLI

The @artemis/cli package is my everyday driver for interacting with Artemis natively. Instead of a basic textual output, it's a fully React-driven terminal UI built on top of Ink.

When you install the CLI globally (pnpm setup:cli), it exposes the standalone artemis binary, allowing you to interface with the agent directly from any directory.

Installation

When inside the main artemis-ai repository, you can alias the CLI globally on your machine:

pnpm setup:cli

This runs pnpm link --global inside the packages/cli directory. Once done, you can run the primary command from anywhere:

artemis

Interactive Chat (TUI)

The default behavior of the CLI accesses the interactive chat mode. It instantly connects your terminal to the central Artemis Gateway via WebSocket.

artemis chat

In-App Shortcuts

The terminal UI has a set of rich shortcuts for agent orchestration without needing to restart the process:

Ctrl+O: Toggles the agent's internal "reasoning" trace visibility.
Ctrl+C: Gracefully exits the session.

Slash Commands

You can also send system commands within the input loop:

/new: Forgets the immediate context window and starts a fresh conversation session.
/clear: Wipes the visible terminal scrolling buffer.
/model <name>: Switches the underlying LLM dynamically (e.g. /model qwen3:14b).
/provider <id>: Switches the inference endpoint (e.g. /provider ollama).

Global Options

The CLI can accept flags to override the default gateway or model mappings configured in .env:

Flag	Abbr	Description
`--gateway`	`-g`	Specifies the Gateway URL (Defaults to `http://localhost:4081`)
`--provider`	`-p`	Set the LLM backend (ollama, openai, anthropic, google)
`--model`	`-m`	Explicit model selection (e.g. `minimax-m2.7:cloud`)

Example:

artemis chat --provider anthropic --model claude-sonnet-4-20250514

Utility Subcommands

The CLI isn't just for chatting. It acts as the central dashboard for the whole system architecture.

Gateway Management

Start, stop, or restart the background gateway daemon natively without needing to babysit terminal processes.

artemis gateway start
artemis gateway stop
artemis gateway restart

Channel Management

If you have multiple channels open (WhatsApp, Discord, etc.), you can easily inspect them:

artemis channels

Provides a live list of the active services attached to the Gateway.

OTP Dashboard

For actions requiring multi-factor elevation (like Gmail authentication or privileged OS commands):

artemis otp

Opens an interactive OTP generation and authorization flow.

Brain / Memory Viewer

Browse your local ~/.artemis/workspace context variables, SKILL datasets, and CHROMA memory vectors interactively:

artemis brain

Configuration

Outputs the loaded system rules, environment secrets mapping, and provider connection status:

artemis config

Backup & Transfer (Export/Import)

You can bundle the entire state of your agent's brain (profiles, memory files, and databases) into a compressed zip archive to move it between machines or back it up:

artemis export [file]

Saves a zip archive containing the ~/.artemis state.

To restore a previously saved brain state:

artemis import <file>

Restores the agent's brain state from the specified zip file.

On this page