跳到主內容

Theme / 0.9.5

Herdr

AI 一人公司的終端辦公室

指令詳解

herdr agent start:員工上崗

在指定的頁面裡、用名冊登記的那家 agent CLI 啟動一位員工,並給它登記英文名。啟動參數帶權限放行配置,決定它能不能直接讀寫整個知識庫。

語法

# 固定崗位
herdr agent start <英文名> --kind <名冊裡的代號> --pane <pane_id> --timeout 60000 -- <那家固定崗位的啟動參數>

# 臨時幫手
herdr agent start tmp-<短名> --kind <名冊裡臨時幫手的代號> --pane <pane_id> --timeout 60000 -- <那家臨時幫手的啟動參數>

--kind 用 Herdr 認的代號:Claude Code 寫 claude、Codex 寫 codex、OpenCode 寫 opencode、反重力寫 agy。那家沒有啟動參數,就連 -- 一起省掉。<pane_id> 來自上一步 tab create 回傳的 result.root_pane.pane_id。

啟動參數從哪來

「各家啟動參數」寫在公司總規矩的員工名冊下面(裝 Herdr 那一步配好的權限放行),照抄即可——各家細節見 Harnesses:

家 固定崗位 臨時幫手
Claude Code --add-dir "<公司根目錄>" --settings "<公司根目錄>/claude-permissions.json" --settings "<公司根目錄>/claude-permissions.json"
Codex --sandbox workspace-write --add-dir "<公司根目錄>" --search
OpenCode (無) (無)
反重力 --add-dir "<公司根目錄>" (無)

成功與失敗

  • 成功:退出碼 0,result.agent.name 是這個英文名
  • agent_not_ready:它一啟動就停在一個問題上。先 herdr agent read <英文名> --source visible 看在問什麼——
    • 只是在問「是否信任這個資料夾」、且路徑在公司根目錄下(老闆已授權):替老闆選信任(不在高亮位置先用 herdr agent send-keys <英文名> down 或 up 移過去),再 herdr agent send-keys <英文名> enter,然後 herdr agent wait <英文名> --until idle --until done --timeout 60000
    • 問的是別的:按協作規矩第 8 條,轉告老闆
  • 報錯說視窗還沒回到命令提示字元:等 3 秒再試一次,最多 3 次
  • 其他報錯:herdr pane read <pane_id> --source recent --lines 40 看頁面裡出了什麼,告訴老闆,不要自己亂試

上崗後

  • 每位啟動成功後,用 herdr agent read <英文名> --source visible 看一眼:頁面裡在要求登入的話,停下來告訴老闆是哪一頁,不要替老闆登入
  • 剛點完「信任」後,狀態可能還停在 blocked 幾秒——等著就好,不要再按一次