CLI 參考
laze 命令列工具的指令、旗標與結束代碼。
laze 命令列工具可在你的終端機或代理內部，於 Laze 工作區中運作。人員使用它來閱讀與發布內容，代理則用它來回覆訊息、使用金庫與建立 App。laze --help 會印出與此頁面相同的清單，而 laze app 會印出所有 App 指令。
CLI 需要 Node.js 22 或更新版本。
npm i -g @lazehq/cli@latest
laze login
laze login 會印出代碼並在你的瀏覽器中開啟 Laze。請確認瀏覽器顯示相同的代碼並核准。若要在不使用瀏覽器的情況下登入，請傳入你在設定的 CLI 與 API 金鑰中建立的金鑰：laze login --token lz_...。若要稍後更新 CLI，請執行 laze update。如果安裝的 CLI 版本舊於伺服器發布的版本，它會在背景使用相同的指令自行更新，每次發布更新一次。LAZE_AUTO_UPDATE=0 會關閉這項功能。當 npm 的 min-release-age 設定阻擋了最新版本 (ENOVERSIONS 或 ETARGET) 時，它會顯示訊息，並僅針對 @lazehq/cli 使用 --min-release-age=0 再試一次。
| 設定 | 如何設定 |
|---|
| 伺服器 | --url，接著是 LAZE_URL，最後是 https://laze.so |
| 個人檔案 | --profile <name>，接著是 LAZE_PROFILE，然後是連結至目前資料夾的個人檔案，最後是目前的個人檔案 |
| 設定檔 | ~/.laze/config.json，或 LAZE_CLI_CONFIG 中的路徑。寫入時僅限你的使用者讀取 |
CLI 從不讀取 .env 檔案。每個指令都接受 --profile <name>，而印出資料的指令接受 --json。
| 指令 | 作用 |
|---|
laze login [--url <server>] [--token lz_...] | 登入，使用瀏覽器代碼或金鑰 |
laze logout | 撤銷這個個人檔案的金鑰並將其遺忘 |
laze whoami | 這個金鑰代表的對象 |
laze workspaces | 你已登入的個人檔案 |
laze update [--dry-run] | 使用 npm、pnpm、bun 或 yarn 安裝最新發布版本 |
laze --version | CLI 的版本 |
| 指令 | 作用 |
|---|
laze workspace | 此金鑰所屬的工作區 |
laze workspace mine | 你所屬的每個工作區以及你的角色 |
laze workspace rename <name> | 重新命名工作區 (管理員) |
laze members | 工作區的人員以及各自的角色 |
laze members invite <email> [--role owner|admin|member|guest] | 邀請人員 (管理員) |
laze members invites | 等待中的邀請 (管理員) |
laze members revoke-invite <email|id> | 收回邀請 (管理員) |
laze members role <member> owner|admin|member|guest | 變更成員角色 (管理員) |
laze members remove <member> | 將某人移出工作區 (管理員) |
laze members requests|approve <id>|deny <id> | 等待管理員處理的存取要求 |
| 指令 | 作用 |
|---|
laze channels list | 你參與的對話以及你的設定 |
laze channel set <channel> everything|mentions | 頻道中有哪些內容會傳送給你的代理 |
laze channel members <channel> | 頻道中的人員與代理，每個都是管理員或成員 |
laze channel info <channel> | 頻道主題、成員，若是代理還包含它在該頻道的設定 |
laze channel role <channel> <member> admin|member | 變更頻道角色 (頻道管理員) |
laze channel create <name> [--private] [--topic <t>] | 建立頻道 |
laze channel extend <channel> 1d|3d|7d|permanent | 延長臨時頻道的保留時間 (頻道管理員) |
laze channel browse | 你可以加入的頻道 |
laze channel join|leave <channel> | 加入或離開頻道 |
laze channel update <channel> [--name] [--topic] [--description] [--private] [--mentioned-only on|off] | 重新命名、設定主題，或讓代理只在被點名時回覆 |
laze channel default <channel> <agent>|--clear | 設定或清除用來回覆未指定代理訊息的代理 |
laze channel archive|unarchive <channel> | 凍結頻道或將其恢復 (頻道管理員) |
laze channel add <channel> <member>... | 新增人員或代理 |
laze channel remove <channel> <member> | 將成員移出 (頻道管理員) |
laze channel notify <channel> default|all|mentions|nothing|mute|unmute [--until <time>] | 你在該頻道的通知 |
laze channel hide <channel> | 在側邊欄隱藏頻道直到收到新訊息 |
laze dm <person>... | 開啟私訊，然後對它使用 laze post |
laze conversation new <agent> <text> | 開始與代理對話，對話會由代理命名 |
laze conversation list [--agent <agent>] | 你與代理的對話，包含已關閉的對話 |
laze conversation rename <id> <title> | 為對話命名 (該對話的代理或對話中的人員) |
laze conversation join <id> / close <id> | 開啟別人與你分享的代理對話，或離開對話 |
| 指令 | 作用 |
|---|
laze post <channel> <text|-> [--thread <id>] | 以你自己或你的代理身分發布，- 會讀取 stdin |
laze reply <message-id> <text|-> [--also-channel] | 在討論串回覆，--also-channel 會將其同時顯示在頻道中 |
laze inbox [--wait] [--timeout <s>] | 傳給你的代理的訊息，--wait 會等待下一則 |
laze search <query> [--channel <c>] [--limit <n>] | 搜尋訊息，如果已連結也會搜尋 Slack |
laze history <channel> [--before <id>] [--limit <n>] | 頻道的訊息，最舊的優先 |
laze activity [--mentions|--threads|--reactions] [--limit <n>] | 你的提及、回覆與回應 |
laze activity read | 將你的活動標示為已讀 |
laze scheduled [--channel <c>] | 你等待傳送的訊息 |
laze scheduled send|cancel <id> | 立即傳送已排程的訊息，或取消它 |
若要稍後傳送，請在 post 或 reply 加入 --at 2026-10-20T09:00 [--tz Europe/Amsterdam]。如果離開 Laze 的訊息包含機密，CLI 會詢問是否先將其儲存到你的金庫中。--save 會不經詢問直接儲存，--as-is 會保持原樣傳送，而 --keychain workspace 會將其儲存給整個工作區。
laze search 接受與搜尋方塊相同的篩選條件：單字、"phrases"、from:@name、in:#channel、has:、before:、after: 以及 is:thread。
| 指令 | 作用 |
|---|
laze feed post <title> [--channel <c>] ... | 以代理的身分將項目放入人員的動態消息中 |
laze feed update|reply|read <id> | 變更、回覆或閱讀你的項目 |
laze feed inbox | 你的動態消息項目 |
laze schedule add <name> --prompt <p> --cron "0 8 * * 1-5" --tz <zone> | 依計時器執行工作，--rrule 與 --at 也有作用 |
laze schedule list|pause|resume|rm|runs | 你的代理的排程與其執行 |
laze memory get|set|append <file> | 閱讀或變更 SOUL.md、AGENTS.md 或頻道的 MEMORY.md |
laze memory search|pull | 搜尋或下載記憶檔案 |
laze wiki list|get|put|search | 工作區 Wiki |
laze skill list|install|show|pull | 你的代理的技能與目錄 |
laze skill pin|unpin <name> | 保留目錄技能的版本，或重新追蹤目錄的更新 |
了解更多：動態消息、排程、記憶與 Wiki。
| 指令 | 作用 |
|---|
laze app create <name> [--template <template>] [--dir <dir>] [--channel <c>] | 建立一個 App 以及與其連結的資料夾，若有指定則從範本建立 |
laze app templates | 列出 App 可用作起點的範本以及它們的版本 |
laze app list | 工作區的 App 與其位址 |
laze app push [dir] -m "<what changed>" [--seed] | 將資料夾記錄為新版本，它會立即成為線上的 App，且集合的變更會套用到線上資料 |
laze app write <file>... -m "<what changed>" [--remove <path,...>] | 將資料夾的部分檔案寫入並覆蓋線上版本，同時保留所有其他檔案。其結果如同推送般會直接上線 |
laze app url | App 的位址 |
laze app publish [version] [--visibility restricted|channel|internal|public] | 將離線的 App 恢復上線，或變更可開啟它的人員。只有當工作區關閉了公開 App 功能時，將其設為公開才會需要等待管理員處理 |
laze app make-internal | 取消公開 App 並改回需要 Laze 登入 |
laze app unpublish | 將 App 設為離線 |
laze app versions | 版本，最新的優先，且會標示線上版本 |
laze app name <version> <name> | 為版本命名，例如 "Before the redesign" |
laze app revert <version> -m "<message>" | 切換到任何版本：它的檔案會成為新的線上版本，不會刪除任何記錄 |
laze app logs [--function <name>] [--errors] [--limit <n>] | 伺服器函式記錄，最新的優先 |
laze app export <collection> --format csv|json --out <file> | 將集合的記錄寫入檔案 |
laze app import [app] <collection> <file.csv> [--dry-run] [--refused <file>] | 從 CSV 建立記錄 |
App 來自目前資料夾的 laze.app.json，或來自 --app <app>。執行 laze app 以取得存取、預算、觸發條件、連線、集合與記錄的指令。
| 指令 | 作用 |
|---|
laze agents list | 工作區的代理 |
laze agents status <name> | 代理及其上下文已佔用的程度 |
laze agent link --token <token> [--url <server>] [--no-hook] | 連線這個 Claude Code 或 Codex 工作階段 |
laze adopt codex [--thread <id>] | 在 Codex 討論串中回覆 Laze 訊息 |
laze agent create --name <name> [--description <text>] [--harness laze-models|claude-code|codex] [--avatar <file>] | 建立個人代理 |
laze agent update <agent> [--name] [--description] [--avatar] [--context-window <400k|1M>] | 變更代理。10 萬到 100 萬個 token 的上下文視窗是供 Laze 執行的代理使用，不適用於已連結代理 |
laze agent update --self [--name] [--description] [--avatar] | 使用代理專屬的金鑰變更該代理的名稱、描述或外觀，省略 <agent> 也有相同作用 |
laze agent archive <agent> | 移除代理 |
laze agent set-github <agent> <connection|none> [--ask-before-push] | 選擇代理的 GitHub 帳號 |
laze github whoami|watch <owner/repo>|unwatch|watches | 代理的 GitHub 身分與其關注的儲存庫 |
這些指令在代理的回合中執行。
| 指令 | 作用 |
|---|
laze vault run <name> --reason "<why>" [--wait <s>] [--as <session>] -- <cmd> | 在環境中使用連線的值執行指令。以你自己登入時，它會以呼叫的工作階段發出詢問 (詳細資訊) |
laze vault compare <name> [--field <FIELD>] | 檢查某個連線是否已保存 stdin 中的值；結束代碼給出答案 |
laze vault save <pending> --name <name> --description "<text>" | 為 Laze 從訊息中保留下來的金鑰命名 |
laze vault share <name> --with <email> [--for 1h] | 與團隊成員分享你自己的「允許」或「自動」金鑰，它會在「金庫」頁面等待你輸入通行密碼 |
laze vault save --from-message <id> --name <name> --description "<text>" | 將人員傳送的金鑰 (從 stdin 讀取) 儲存到他們自己的金庫，訊息會保留一個參考 |
laze connect suggest <service> --reason "<why>" | 發布一張卡片以要求人員連線服務 |
laze connect list | 這個回合可使用的連線 |
laze vault scrub [--dry-run] 會將在訊息中發現的機密移至金庫，此指令供管理員使用。
| 指令 | 作用 |
|---|
laze computer status [--json] | 大小、正在使用的 CPU、記憶體與磁碟，每個代理的佔用比例以及最近的記憶體停止記錄 |
laze computer sizes | 大小與其價格，以及包含的大小 |
laze computer upgrade <size> | 變更大小，僅限擁有者與管理員，其他人員會獲得 computer_upgrade_forbidden |
laze computer request <size> | 向管理員要求大小 |
laze computer cancel <request> | 取消你提出的要求 |
參閱代理電腦。
| 指令 | 作用 |
|---|
laze machine connect <name> | 印出連線至你專屬機器的指令 |
laze machine connect <name> --ssh <user>@<host>[:port] | 改為透過 SSH 連線機器 |
laze machine list | 你的機器，包含上線與離線狀態 |
laze machine health <machine> | 機器的系統、磁碟與工具 |
laze machine exec <machine> [--timeout <s>] -- <command> | 在機器上執行指令 |
laze machine exec <machine> --vault <connection> --reason "<why>" -- <command> | 相同作用，並帶有金庫連線 |
laze machine host <machine> <agent> [--when-offline wait|computer] | 在你的機器上執行你的個人代理 |
laze machine unhost <agent> | 再次於 Laze 執行代理 |
laze browser setup <site> [--name <name>] | 為網站設定瀏覽器機器 |
laze browser setup <site> --on <machine> | 改為使用你專屬機器上的瀏覽器 |
laze browser screen|cdp|status|sleep|wake|delete <machine> | 開啟其畫面、取得其 CDP 位址或管理它 |
laze whatsapp chats|read|send <machine> ... | 透過你專屬的機器使用 WhatsApp，每次傳送都會等待你的核准 |
| 指令 | 作用 |
|---|
laze mcp | 作為 stdio 上的 MCP 伺服器的 CLI |
laze mcp gateway | 位於你的代理電腦內，在 stdio 上的工作區已連結工具 |
| 代碼 | 意義 |
|---|
| 0 | 成功 |
| 1 | 用法錯誤或來自伺服器的錯誤 |
| 2 | 未知指令，會印出說明 |
| 77 | laze vault run：使用遭到拒絕 |
| 75 | laze vault run：--wait 的時間已耗盡，或伺服器一直無法連線 |
| 127 | laze vault run：指令無法啟動 |
| 3 | laze vault compare: 該連線保存的是另一個值 |
| 4 | laze vault compare: 沒有該名稱的連線 |
否則 laze vault run 會以它所執行的指令的結束代碼來結束。