一个窗口，
看住所有 Agent。One window
for every agent.

1. 运行中Working

   这一轮还没结束。Claude Code 用它自己的 hooks 报告状态：AgentDeck 只在启动时加上参数，不改你的设置文件。Grok 和 Codex 也能这样报告，在「管理 Agent」里打开就行：它们只从自己的配置目录读 hooks，所以会各新建一个 AgentDeck 自己的文件，你已有的配置不动。没有 hooks 的 Agent 靠回车、响铃、通知和进度来判断。

   This turn is still going. Claude Code reports through its own hooks: AgentDeck passes flags at launch and never edits your settings files. Grok and Codex can report the same way once you turn it on in Manage Agents. They only read hooks from their own config folder, so each gets one new file of AgentDeck's own, and your existing config is left as it is. Agents without hooks are read from generic signals: Return, the bell, notifications, and progress.

   在上面的窗口里看Show in the window

2. 等你Needs you

   权限确认、一个问题，或一条通知。⌘⇧J 跳到下一个这样的会话。响铃和通知也会在 Dock 上标出来。

   A permission prompt, a question, or a notification. ⌘⇧J jumps to the next session that needs you. Bells and notifications also badge the Dock.

   在上面的窗口里看Show in the window

3. 本轮完成Turn done

   这一轮结束了，会话还在。点进去可以接着看。退出之后再开，也会回到同一段对话。

   This turn is finished, and the session is still there. Open it to read the result. After it exits, starting it again returns to the same conversation.

   在上面的窗口里看Show in the window

4. 已退出Exited

   Agent 进程结束了，你回到 shell。再启动会接着上次的对话。

   The agent process has ended and you are back at the shell. Starting it again continues the last conversation.

   在上面的窗口里看Show in the window

刚启动、还在等第一次输入时，显示「就绪」。普通 Shell 没有这些状态。SSH 断了以后会出现重连按钮，提示为「已断开」，⌘⇧R 也会重连。

Right after launch, before the first prompt, the label is 就绪. A plain shell has none of these states. A dropped SSH session gets a reconnect button, described as 已断开. ⌘⇧R reconnects too.

• 等你的排在最前Waiting comes first

  按状态分组：等你、运行中、空闲、已退出。等你的那一行直接写着它在等什么，每行还有它在这个状态里停了多久。也可以改成按文件夹分组。

  Grouped by state: needs you, working, idle, exited. A waiting row says what it is waiting for, and every row shows how long it has been in that state. You can group by folder instead.

• 不进去也能回Answer without going in

  选中一行，下面是它终端的最后几行。在输入框里打字、回车，回复就发给这个 Agent，你还留在列表里。

  Select a row and the last lines of its terminal appear below. Type in the field and press Return: the reply goes to that agent, and you stay on the list.

• 回车进到它的会话Return opens its session

  ↩ 或双击，切到它所在的会话，光标落在它的窗格里。esc 或点侧边栏里任何一个会话，回到终端。

  ↩ or a double-click goes to its session, with the cursor in its pane. esc, or any session in the sidebar, returns to the terminal.

• 在列表里派任务Hand out tasks from the list

  列表上方有一条派发栏：选 Agent、选文件夹、写下任务、回车。新的 Agent 带着这个任务在后台开工，你留在列表里，可以接着派下一个。

  A bar above the list starts new work: pick the agent and the folder, write the task, press Return. A new agent starts on it in the background, and you stay on the list to hand out the next one.

• 停下它，或者替它选Stop it, or pick for it

  运行中的 Agent 可以直接「停止」这一轮。它停下来等你选的时候，回复框旁边有 123↩esc，对应它提示里的选项，不用进终端。

  A working agent can be stopped for this turn. When it stops to ask you to choose, 123↩esc sit next to the reply field and answer its prompt, without going to the terminal.

• 筛选和置顶Filter and pin

  顶部的输入框按名称、Agent 或文件夹筛选。右键可以把一个 Agent 置顶，它不管在干什么都排在最上面，重启 App 后还在。

  The field at the top filters by name, agent, or folder. Right-click to pin an agent: it stays at the top whatever it is doing, and stays pinned after a relaunch.

在上面的窗口里看Show in the window

还有这些Also

• 内置 Claude Code、Codex、Grok、Gemini 和 Shell。其他命令行工具可以自己加。还没安装的，会给出安装命令。命令是打进登录 shell 的，Agent 退出以后，你还在那个 shell 里。Built in: Claude Code, Codex, Grok, Gemini, and a shell. Any other CLI can be added. Ones that are not installed come with an install command. The command is typed into your login shell, so when the agent exits you are still in that shell.
• 状态跟着窗格走，不跟着会话。在分屏里自己敲 claude 或 codex，AgentDeck 也认得出来，它会有自己的状态，也会出现在总览里。Status belongs to the pane, not the session. Type claude or codex into a split yourself and AgentDeck notices: it gets its own status and its own row in the overview.
• 剪贴板里如果是截图，⌘V 会先存成 PNG，再贴上路径，这样就能把图交给 Agent。拷进来或拖进来的文件，会变成 shell 转义后的路径。If the clipboard holds a screenshot, ⌘V saves a PNG and pastes the path, which is how you hand an image to an agent. Copied or dragged files paste as shell-escaped paths.
• 中文、日文、韩文输入法可以用，候选窗贴着光标。Chinese, Japanese, and Korean input methods work, with the candidate window anchored at the cursor.
• 会话可以重命名，也可以放进分组。分组是侧边栏里可折叠的一段。Sessions can be renamed or moved into a group. A group is a collapsible section in the sidebar.
• 性能面板里还有 Docker。可以看容器日志、进容器开一个 shell，也可以启动、停止或重启。从容器打开的会话，下次启动 App 时不会恢复。The performance panel also lists Docker containers. You can open logs, a shell inside a container, and start, stop, or restart one. Sessions opened from a container are not restored on the next launch.
• 每天会查一次更新，菜单里也可以自己检查。更新来自 GitHub Releases，要有 EdDSA 签名，并且 Developer ID 得和当前这个 App 一致。如果有 Agent 正处在这一轮里，重启前会先问你。AgentDeck checks for an update once a day, and you can check from the menu. Updates come from GitHub Releases. Each one is EdDSA-signed and must carry the same Developer ID as the app you have. If an agent is mid-turn, it asks before restarting.