herdr 图形客户端
herdr 是编程 Agent 运行的地方：Claude Code、Codex、pi 等在它的面板里运行，按工作区和标签页组织，关掉终端也不会停。Alma 是它的图形客户端，支持 macOS、Windows、Linux 和 iPhone。
Agent 照常在 herdr 里运行。Alma 连接你电脑上的 herdr 服务，把每个面板变成能读、能回复的界面。
开始使用
不需要任何配置。Alma 按照 herdr 自己的方式查找它的 socket：
| 位置 | 何时使用 |
|---|---|
HERDR_SOCKET_PATH 或 HERDR_SOCKET | 在 Alma 的环境或登录 Shell 中设置了它 |
<config>/herdr/sessions/<名称>/herdr.sock | HERDR_SESSION 指定了会话 |
<config>/herdr/herdr.sock | 默认会话 |
<config> 依次为 XDG_CONFIG_HOME（若已设置）、Windows 上的 %APPDATA%、其他情况下的 ~/.config。Windows 上 herdr 监听命名管道，Alma 会连接它。
Alma 还会读取登录 Shell 的环境变量，所以即使 Alma 是从程序坞或开始菜单打开的，也能找到在终端里启动的 herdr。
每个 Agent 都是一段对话
在侧边栏选一个面板，Alma 会把 Agent 的会话显示为对话，而不是终端：
- 直接读取 Claude Code、Codex 和 pi 的会话记录，工具调用、子 Agent 和文件改动按顺序排好。
- 在输入框里输入即可回复。发送的内容会进入该面板里的 Agent，就像你在那里直接输入一样。
- 随时切到屏幕视图查看真实终端。
谁在等你
侧边栏按状态给 Agent 分组：
- 需要输入：Agent 问了你问题，正在等待。
- 工作中：Agent 正在进行一轮操作。
- 已完成：Agent 做完了，未读的轮次会标出来。
Agent 需要你或完成时，Alma 会发送桌面通知。不想被打扰的工作区或标签页，可以在它的菜单里静音。
工作区与标签页
herdr 有的，Alma 都有：
- 新标签页：在当前工作区启动一个 Agent。
- 新工作区：选择一个文件夹（会列出最近使用的）以及要在里面启动什么。
- 在菜单里重命名、排序、静音和关闭工作区与标签页。关闭标签页会退出其中的 Agent，会话仍保留在电脑上。
- 侧边栏可按 herdr 原顺序、按状态或按名称排序。
其他电脑
一个 Alma 可以操控多台电脑上的 Agent。在**添加电脑…**中，粘贴另一台电脑上 Alma 的 设置 › 远程访问 里的配对链接即可。能直连时 Alma 走局域网，否则通过端到端加密的 Alma 中继连接。
在 iPhone 上
iPhone 版（公测中，通过 TestFlight 安装）与电脑上的 Alma 配对后，同样的 Agent 都会跟过来：
- 阅读并回复每个 Agent，也能启动新的。
- Agent 需要你时收到推送通知。
- 远程屏幕：在手机上查看并操控 Mac 的屏幕。需要在 Mac 上为 Alma 开启屏幕录制和辅助功能权限。
- 模拟器：查看并操作那台电脑上运行的 iOS 模拟器或 Android 模拟器。
常见问题
“herdr 没有运行”：在那台电脑上启动 herdr。如果它使用命名会话或自定义 socket，请确认登录 Shell 中设置了 HERDR_SESSION 或 HERDR_SOCKET_PATH，然后点击重新连接。
“请更新那台电脑上的 Alma”：那台电脑上的 Alma 比这台旧，去那边更新即可。