Commands — Alius Docs

CLI Entry Commands

Command	Description
`alius`	Launch the interactive TUI workspace
`alius repl`	Explicitly launch the interactive workspace
`alius run -p "..."`	One-shot non-interactive request
`alius init`	Initialize project configuration (reset and open the initialization wizard)
`alius config`	Display, validate, and update configuration state
`alius version`	Display the compiled version number
`alius core`	Manage the official Soul repository cache
`alius soul`	Manage installed Soul cache entries and the current project Soul
`alius plugin`	List, install, inspect, and remove Rust WASM tool modules
`alius mcp`	List, start, and inspect MCP server tools
`alius workflow`	List, validate, and run workflow definitions

`alius run` One-shot Execution

alius run -p "Perform a structured code review on this module"

alius run behavior:

Executes a single request in Chat mode
The model may request one tool call, but will not enter multi-turn iteration
Streams results to standard output
Can override the model with the --model parameter

`alius config` Configuration Command

alius config show       # Display current configuration
alius config validate   # Validate configuration integrity
alius config soul --role <role>  # Configure Soul role
alius config credential # Manage API credentials

`alius core` and `alius soul`

Command	Description
`alius core update`	Update or clone the official Soul repository cache
`alius soul update`	Sync official Souls to the local cache
`alius soul list`	List installed Soul cache entries

alius core manages the official repository cache, while alius soul manages locally installed Souls. These are different operations.

TUI Slash Commands

Within the workspace, you can use slash commands to perform various operations.

Command	Description
`Shift+Tab`	Switch between Plan / Bypass mode
`Ctrl+Enter`	Submit current input
`Esc`	Clear input or cancel current operation
`Ctrl+C` / `Ctrl+D`	Exit the workspace

Inside the configuration center or initialization wizard, Tab / Shift+Tab switch configuration tabs or steps, not execution modes.

Initialization and Configuration

Command	Description
`/init`	Launch the initialization wizard (resumable state machine)
`/config`	Open the embedded configuration center (Models/Language/Soul tabs)
`/model`	Open the model pool manager (add/view/delete models)

`/init` Initialization Wizard

/init clears the session area (including the welcome block), then launches the embedded initialization wizard.

Wizard steps:

Language — Choose the interface language
Model pool — Import models from remote providers
Model assignment — Assign Plan/Execute/Review models
Soul — Choose the Agent role

Wizard features:

Resume from where you left off
Shift+Tab to go back to the previous step
Completed steps are marked ✓ and automatically skipped
Auto-saves and exits on completion

`/config` Configuration Center

Tab	Content
Models	Plan Model / Execute Model / Review Model assignment
Language	Interface language selection
Soul	Agent role selection

Controls:

Tab / Shift+Tab switch tabs
Up / Down navigate options
Space toggle multi-select
Enter confirm
Esc exit (takes effect immediately, no save needed)

/config does not call the model or fetch model lists remotely. It only reads the local model pool. Remote fetching only occurs during the /model add flow.

`/model` Model Pool Manager

View imported models (shows provider, Base URL, and API mode)
Add models: select provider → API mode (OpenAI API / Anthropic API) → Base URL → API Key → remote fetch → multi-select to import
Delete models: remove imported entries (models currently in use by /config cannot be deleted)

Supported providers:

BigModel GLM (Zhipu Coding Plan)
Xiaomi MiMo (Token Plan)
DeepSeek

API Key input is in plaintext and supports pasting. After saving, the Key is not displayed in session output or model details.

Session Management

Command	Description
`/session current`	Display current Session information
`/session new`	Start a new development round
`/session list`	List all Sessions
`/session load <id>`	Restore a previous Session
`/session clear`	Clear current Session messages

Memory

Command	Description
`/memory save <text>`	Save a fact or lesson
`/memory list`	View saved memories
`/memory clear`	Clear global memory

Review and Debug

Command	Description
`/review`	Review the Agent’s last response
`/tools`	List available tools
`/clear`	Clear the screen

Conversation Block Operations

Action	Description
Click collapsed block	Expand/collapse a single conversation block
`Ctrl+O`	Expand/restore all collapsed blocks
`Shift` + select	Release mouse capture for native terminal text selection

Long conversation blocks (over 3 lines) auto-collapse. Welcome blocks, ConfigOverview blocks, and empty execution blocks do not collapse.

Legacy REPL

If you need to use the old rustyline REPL interface:

ALIUS_LEGACY_REPL=1 alius

The legacy REPL supports slash commands and terminal streaming output, but is not the primary product interface.

CLI Entry Commands

alius run One-shot Execution

alius config Configuration Command

alius core and alius soul