什么是 Agent CLI？

Agent CLI 是一个本地优先的 AI Agent 运行时工作空间。它将你的开发意图转化为可恢复的 Session、可观测的 Run、可审计的 Trace，以及项目记忆——全部存储在你的工程工作空间中。

它不是一个套在终端里的聊天机器人。Alius 为能够参与自身进化的软件而构建：理解目标、生成计划、通过受控的运行时边界执行、记录证据、审查结果，并将学习带入下一次迭代。

核心特性

  • Plan 驱动工作空间 — 不是简单的对话界面，而是围绕目标理解、计划生成、受控执行和结果审查构建的 Agent 运行时
  • 双模式执行 — Plan 模式用于复杂的多步骤任务，Bypass 模式用于快速单轮交互
  • 项目级配置 — 模型池、角色身份、安全策略全部以项目为单位管理
  • 分层记忆 — 工作记忆、经验记忆、事实记忆三层体系，跨 Session 积累项目知识
  • 安全边界 — Shell Gate 对所有 shell 和文件操作进行风险分析和审批控制
  • 本地优先 — 所有数据存储在 .alius/ 目录中，不强制上传任何数据

系统要求

  • macOS 12+ 或 Linux (x86_64 / ARM64)
  • Windows 10+ (PowerShell)
  • Node.js 18+（用于 npm 安装）
  • Rust 1.75+（仅用于从源码构建）

快速安装

curl -fsSL https://alius.tech/install | sh

或通过包管理器安装：

# npm
npm install -g @alius-tech/alius

# Homebrew
brew tap AliusTech/tap
brew install alius

验证安装：

alius --version

初始化项目

在你的项目目录中运行：

cd your-project
alius init

alius init 会启动交互式初始化向导，引导你完成：

  1. 语言选择 — 选择工作空间的界面语言
  2. 模型池配置 — 从支持的服务商导入模型（BigModel、小米 MiMo、DeepSeek 等）
  3. 模型分配 — 为 Plan、Execute、Review 三个角色分别指定模型
  4. Soul 选择 — 选择 Agent 的角色身份

初始化完成后，项目目录下会生成 .alius/ 结构：

your-project/
├── .alius/
│   ├── config/         # 项目配置（providers.toml, model.toml, soul.toml 等）
│   ├── memory/         # 项目记忆存储
│   └── workspace/      # 工作空间文档
├── src/
└── ...

初始化向导是可恢复的。如果你中途中断，下次运行 alius init 可以选择继续之前的进度。

进入工作空间

启动交互式工作空间：

alius

你将看到基于 Ratatui 的 TUI 工作空间界面，包含：

  • 顶部栏 — 版本、Soul、模式和网络状态
  • 会话区 — 工作流对话块（请求、理解、计划提案、执行、提示、输出、错误）
  • 计划面板 — 计划节点、状态、验收标准和证据（仅在 Plan 模式批准后出现）
  • 交互区 — 文本输入、选项选择和审批控件
  • 状态栏 — 当前工作空间、Git 状态和运行时状态

两种执行模式

在 TUI 工作空间中，你可以通过 Shift+Tab 在两种模式间切换：

Plan 模式（默认推荐）

适用于复杂的多步骤任务。工作流程：

  1. 你描述目标
  2. 模型主动询问不明确的需求细节（以选择题或填空形式）
  3. 模型生成可执行的计划列表
  4. 你审批计划
  5. 批准的计划节点按步执行
  6. 执行完成后确认关闭计划面板

Plan 模式支持最多 20 次迭代，可以调用工具、执行 shell 命令并检查收敛。

Bypass 模式

适用于快速的单轮交互——提问、澄清、轻量分析。Bypass 模式直接将输入发送到单轮执行，模型可能会请求一次工具调用，但不会进入多轮迭代。

一次性执行

如果你不需要交互式工作空间，可以直接运行单次提示：

alius run -p "对这个模块执行结构化代码审查"

这是单次命令，直接在 Chat 模式下执行并将结果流式输出到标准输出。

下一步