Installation and Startup

alius command not found after installation

Ensure the installation path is in your PATH environment variable:

# Check alius path
which alius

# If installed via npm, check the global path
npm list -g @alius-tech/alius

alius exits immediately after startup

Check for missing environment configuration:

  1. Run alius init to initialize the project
  2. Confirm .alius/config/providers.toml has a valid provider and API Key configured
  3. Confirm that at least Plan/Execute/Review models are assigned

Model fetch fails during alius init

If the remote model list fetch fails:

  1. Check your network connection and whether the API Key is valid
  2. The /model add flow supports manual model name entry as a fallback
  3. Confirm the Base URL is correct

Workspace

Workspace startup reports missing API Key

After successfully importing models in /init, the API Key is written to the active runtime settings. If you manually edited providers.toml, confirm that api_key_env points to the correct environment variable.

Model assignment error “model not enabled”

Before checking model assignments in /config, confirm the model’s enabled status is true in /model.

Cannot delete a model

Models currently used by Plan Model, Execute Model, or Review Model cannot be deleted. Change the assignment in /config first, then delete the model.

Execution Modes

Tool calls paused in Plan mode

This is expected behavior. Operations requiring approval in Plan mode (file writes, risky Shell commands, etc.) pause and wait for your confirmation. You can choose to approve or reject.

Risky operations executed automatically in Bypass mode

In Bypass mode, Shell Gate’s ApprovalRequired decisions are executed directly rather than showing a confirmation prompt. If you don’t want certain operations to execute automatically, work in Plan mode or set the relevant operations to deny in permissions.toml.

Memory

Where is memory data stored?

All memory is stored under the project directory’s .alius/memory/. No data is transmitted externally.

How to clear project memory?

/memory clear

This clears global memory. Project memory is managed through memory_list and memory_clear runtime operations.

Legacy REPL

How to use the old REPL interface?

ALIUS_LEGACY_REPL=1 alius

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

More Help