CLI 指南

termdock 命令列工具的常用指令與參數、範例工作流。

termdock CLI

自 v1.11 起，Termdock 內建 termdock 命令列工具，透過本地 control socket 與 Terminal API 和執行中的 app 溝通。你可以從任何 shell — 包括 Termdock 裡面的 shell — 識別、建立、控制 session、管理窗格版面，以及安裝 AI agent 掛勾。

身分與主機偵測

termdock identify --json      # 印出當前 workspace/pane/session 身分
termdock hostinfo --json      # 偵測所在的主機終端（多訊號、離線可用）

Session 操作（v1.12+）

termdock session create --workspace <id> [--name <name>] [--background] --json
termdock session list --json
termdock session output <id> [--mode raw|text|content|screen] [--lines <n>] --json
termdock session output <id> --follow          # 即時串流輸出
termdock session input <id> <text> [--enter] --json
termdock session attach <id>                   # 從 shell 直接接上 session
termdock session destroy <id> --json

版面控制（v1.12+）

termdock layout get --json
termdock layout set <type> [--sessions <id,id>] --json
termdock layout assign <pane-id> <session-id|none> --json
termdock layout activate <pane-id> --json

Agent hooks 與 Workstream（v1.13+）

termdock hooks status [--agent claude|codex|gemini] [--json]
termdock hooks setup [--agent claude|codex|gemini] [--dry-run]
termdock hooks uninstall [--agent claude|codex|gemini] [--dry-run]
termdock hook ingest --json [--wait]           # 橋接 provider hooks

hooks setup 安裝 provider 掛勾後，agent 的權限請求、提問與 exit plan 會彙整到 Workstream 面板，不用切換終端就能直接回覆。加上--dry-run 可以先預覽、不實際寫入。

全域選項

--help, -h           顯示說明
--version, -v        顯示 Termdock CLI 版本
--url <url>          Terminal API base URL
--token <token>      Terminal API bearer token