异色剂- cli

以太 CLI 号舰作为单一的二进制, aether,带有每种使用方式的子命令:

• aether 交互式 TUI( 无参数运行时的默认值)
• aether headless ——脚本/CI的单速无头跑
• aether acp —— 说 代理客户协议( ACP) 兼容编辑器/IDE客户端的 v2 服务器
• aether settings init --user|--project ——初始化用户或项目设置
• aether show-prompt ——打印全组装系统快取(调试)

目录

• 安装
• 快速启动
  • 互动 TUI
  • 无头
  • ACP 服务器
• 选择一个模型
• 编辑器集成( ACP)
  • 齐德
• MCP 配置
• 斜线命令
• 设置
  • 代理人(模式和子代理人)
• 日志

安装

选择适合您工作流程的任意:

# npm (cross-platform)
npm install -g @aether-agent/cli

# Homebrew (macOS / Linux)
brew install contextbridge/tap/aether

# Shell installer (macOS / Linux)
curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/contextbridge/aether/releases/latest/download/aether-agent-cli-installer.sh | sh

# From source
cargo install aether-agent-cli

要从工作空间检查中构建 :

cargo build --release -p aether-agent-cli
# binary lands at target/release/aether

快速启动

互动 TUI

aether

如果不存在用户设置或项目设置,二进制会在启动TUI前启动用户级上载. 要明确初始化, 运行 aether settings init --user 个人违约,或 aether settings init --project 用于项目本地代理的存储器根.

无头

aether headless -m anthropic:claude-sonnet-4-5-20250929 "Refactor auth module"

有用的旗帜 : -a/--agent (从设置中指定代理人), -C/--cwd, (中文(简体) ), --system-prompt, (中文(简体) ), --output text|json, (中文(简体) ), --events tool_call,tool_result,..., (中文(简体) ), --mcp-config <path>, (中文(简体) ), --settings-file <path> 编号 : --settings-json <json>。通过提示作为位置的正弦, 或把它吹到Stdin上.

ACP 服务器

aether acp --model anthropic:claude-sonnet-4-5-20250929 --mcp-config mcp.json

旗帜 : --agent <name> (与 --model, (中文(简体) ), --reasoning-effort low|medium|high|xhigh, (中文(简体) ), --log-dir <path>,加上同样的 --settings-file 编号 : --settings-json 选项.

选择一个模型

Aether 支持多个 LLM 提供者使用 provider:model 字符串格式 :

编辑器集成( ACP)

齐德

对于ACP v2 支持的 Zed 版本,请加入您的 settings.json (主菜单-"打开设置文件"):

{
  "agent_servers": {
    "Aether Agent": {
      "command": "/path/to/aether",
      "args": [
        "acp",
        "--model",
        "zai:GLM-4.6",
        "--mcp-config",
        "/path/to/your/project/mcp.json"
      ],
      "env": {
        "RUST_LOG": "debug",
        "ZAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

然后打开 代理小组 并选择“新以太代理线索”.

重要内容: 更新路径和配置 :

• command: 通向 aether 二进制(例如: which aether 或者说 target/release/aether(中文(简体) )
• --mcp-config: 您的 MCP 配置文件路径
• 为您的模型提供者设置合适的 API 密钥 env var

MCP 配置

这个 mcp.json 文件配置 MCP 工具服务器 :

{
  "servers": {
    "coding": {
      "type": "in-memory",
      "args": ["--rules-dir", ".aether/skills", "--rules-dir", ".claude/rules"]
    },
    "skills": {
      "type": "in-memory",
      "args": [
        "--dir", ".aether/skills",
        "--dir", ".claude/skills"
      ]
    }
  }
}

• 编码 —— 文件系统工具(读取、写取、拍取等) 外加配置的可选自动读取规则 --rules-dir 路径
• 技能 —— 从配置中加载的斜线命令和可重复使用的提示 --dir 路径

设定 "deferTools": true 在服务器上保持其策略不包含模型可见工具定义. 使用 aether mcp --help 然后发现被推迟的服务器 aether mcp <server> --help 财务报告和审定财务报表 aether mcp <server> <tool> --help 检查工具和计划。 使用 --json '{...}' 或JSON在Stdin上的物体。 用于分区工具 "deferTools": { "include": [...], "exclude": [...] };条目是准确的 MCP - 本地名称,跟踪..* 前缀, 或注释匹配符, 如 { "readOnly": true },以及 exclude 赢了.

斜线命令

斜线命令是由 skills 任何通过目录的 MCP 服务器 --dir。每个条目要么是单个条目 .md 文件或包含 SKILL.md (加上可选的辅助文件). 使一个迅速出现作为一个 /slash-command 在 TUI / 非加太客户端中设置 userInvocable: true 在它的前题.

示例 .aether/skills/plan.md数字 :

---
description: Create a detailed implementation spec for a task
argumentHint: <task description>
userInvocable: true
---

You are an expert software architect. Create a comprehensive technical specification.

# Task
$ARGUMENTS

前题字段 :

• description ——在命令拾取器中显示
• argumentHint 参数的可选提示字符串
• userInvocable ——曝光快报为: /slash-command
• agentInvocable ——将提示暴露为其他特工能够掌握的技能 get_skills 反对
• tags 用于 list_skills 发现表面

体内参数语法:

• $ARGUMENTS ——全参数字符串(例如. /plan add user auth → add user auth(中文(简体) )
• $1, (中文(简体) ), $2, (中文(简体) ), $3 ——立场论证

设置

用户级设置位于 $AETHER_HOME/settings.json 或者说 ~/.aether/settings.json项目级代理配置 .aether/settings.json 在您的项目根。 以太先加载用户设置,然后是工程设置;匹配名的项目代理覆盖用户代理. 设置定义代理(modes和子代理),默认提示,以及默认的MCP服务器配置.

代理人(模式和子代理人)

定义具有特定模型、提示和工具配置的代理 :

{
  "agent": "planner",
  "prompts": [".aether/prompts/shared.md", "AGENTS.md"],
  "mcps": [".aether/mcp.json"],
  "agents": [
    {
      "name": "planner",
      "description": "Planner optimized for decomposition and sequencing",
      "model": "anthropic:claude-sonnet-4-5",
      "reasoningEffort": "high",
      "userInvocable": true,
      "agentInvocable": true
    },
    {
      "name": "researcher",
      "description": "Read-only research agent",
      "model": "anthropic:claude-sonnet-4-5",
      "userInvocable": false,
      "agentInvocable": true,
      "prompts": [".aether/prompts/researcher.md"],
      "mcps": [".aether/researcher-mcp.json"],
      "tools": {
        "allow": [{ "readOnly": true }],
        "deny": []
      }
    },
    {
      "name": "coder",
      "description": "Fast coding agent",
      "model": "deepseek:deepseek-v4-flash",
      "userInvocable": true,
      "agentInvocable": false,
      "prompts": [".aether/prompts/coder.md"]
    }
  ]
}

• agent ——可选的默认用户可退出代理名称.
• 顶级 prompts ——未定义自己的代理使用的已订购的默认快捷源 prompts。文件路径可以作为字符串写入; 键入对象支持 { "type": "text", "text": "..." }, (中文(简体) ), { "type": "file", "path": "..." },以及 { "type": "glob", "pattern": "..." }。 。 。 .
• 顶级 mcps ——命令未定义自己的代理使用的默认 MCP 配置源 mcps。文件路径可以作为字符串写入; 键入对象支持 { "type": "file", "path": "...", "deferTools": false } 内置 { "type": "inline", "servers": { ... } } 条目.
• 探员 prompts ——可选命令快速源覆盖顶层 prompts 为了那个特工 支持与顶级相同的字符串短手和输入对象 prompts。 。 。 .
• 探员 mcps ——可选命令超顶级的MCP配置源 mcps 为了那个特工 支持与顶级相同的字符串短手和输入对象 mcps。 。 。 .
• userInvocable: true ——代理作为模式选项出现在ACP客户端(例如Wisp's Shift+Tab)中
• agentInvocable: true 代理可以被产入子代理
• tools ——过滤代理工具可以使用的 MCP (可选) 。 支助 allow (清单)和 deny (块列表)条目. 条目可以是准确的/train --* 名称图案,例如 coding__read_file 或说明匹配者,例如: { "readOnly": true }, (中文(简体) ), { "destructive": false }, (中文(简体) ), { "idempotent": true },以及 { "openWorld": false }如果两者都设定好了, allow 首先应用,然后 deny 从结果中删除。 关闭或留空以允许所有工具 .

您可以通过交互方式进行脚手架设置 aether settings init --user 或者说 aether settings init --project。直接编辑生成的设置 JSON 以自定义代理 .

日志

ACP 运行日志到 --log-dir (默认 : /tmp/aether-acp-logs/) (中文(简体) ). 控制动词 RUST_LOG 环境变量.