Armadra

使用

Agent 与 CLI

支持的 CLI、状态通道、恢复会话、权限模式与会话视图。

Armadra 启动真实 CLI,保留各自的账户、模型选择、工具策略与会话格式。

支持的 Agent

CLI 状态通道 恢复会话 非默认权限模式
Claude Code 命令 Hook --resume ID auto-edit / full-auto / plan
Codex 命令 Hook resume ID auto-edit / full-auto / plan
OpenCode 插件 --session ID CLI 默认
Pi 进程内扩展 --session PATH_OR_ID CLI 默认
Oh My Pi 进程内扩展 --resume ID auto-edit / full-auto
GitHub Copilot 命令 Hook --resume ID auto-edit / full-auto / plan
ama 宿主适配器 --resume ID auto-edit / full-auto / plan

ama 是 Armadra 自带的协调 Agent。也可以添加自定义 CLI,借用任一内置 CLI 的启动形状。

状态通道

节点头部的状态与自动化的空闲判断,都来自 CLI 自己的回报:Claude Code、Codex、Copilot 通过命令 Hook,Pi 与 Oh My Pi 通过进程内扩展,OpenCode 通过插件。这些只在从画布启动时注入。

模型与权限

  • 节点头部的「更多 → 模型」列出该 CLI 文档里的模型别名,选择后在下一次启动时生效。
  • 权限模式只提供 CLI 有对应参数的那些;不支持的模式会在启动前明确报错,不静默降级。
  • 节点可以绑定 Claude 或 Copilot 的第二个账号。

会话视图(ACP)

同一个 Agent 可以在终端视图与会话视图之间切换。会话视图里是消息流、工具调用、文件差异和权限卡;助手回复可以一键落成便签、白板对象或编辑器节点。连线读取、消息、投递与休眠在两种视图下一样。Copilot 在会话视图下不能接回已有会话。

节能休眠

空闲的 Agent 可以先退出 CLI 再结束进程,聚焦、收到投递或计划到点时用 resume 接回原会话。

Guides

Agents and CLIs

Supported CLIs, status channels, resuming sessions, permission modes and the conversation view.

Armadra launches real CLIs and keeps their accounts, model choice, tool policy and session format.

Supported agents

CLI Status channel Resume Extra permission modes
Claude Code Command hook --resume ID auto-edit / full-auto / plan
Codex Command hook resume ID auto-edit / full-auto / plan
OpenCode Plugin --session ID CLI default
Pi In-process extension --session PATH_OR_ID CLI default
Oh My Pi In-process extension --resume ID auto-edit / full-auto
GitHub Copilot Command hook --resume ID auto-edit / full-auto / plan
ama Host adapter --resume ID auto-edit / full-auto / plan

ama is Armadra’s own coordinator agent. You can also add custom CLIs that borrow the launch shape of any built-in one.

Status channels

Node header status and the idle checks used by automation both come from the CLI reporting on itself: Claude Code, Codex and Copilot through command hooks, Pi and Oh My Pi through in-process extensions, OpenCode through a plugin. All of these are injected only when launched from the canvas.

Models and permissions

  • More → Model in the node header lists the model aliases from that CLI’s own docs; the choice applies on the next launch.
  • Only permission modes the CLI has flags for are offered; an unsupported mode fails clearly before launch instead of silently downgrading.
  • A node can be bound to a second Claude or Copilot account.

Conversation view (ACP)

The same agent can switch between a terminal view and a conversation view. The conversation view shows the message stream, tool calls, file diffs and permission cards; a reply can become a note, a whiteboard object or an editor node in one click. Link reads, messages, delivery and hibernation behave the same in both views. Copilot cannot resume an existing session in the conversation view.

Eco hibernation

An idle agent can exit its CLI and end the process, then resume the same session when focused, when a delivery arrives or when a schedule fires.

在 GitHub 上编辑本页 Edit this page on GitHub