安裝
需要 Node.js 22 或更新版本。全域安裝即可取得 ceum 命令:
npm install -g @ceum/cli
或者不安裝,直接執行一次:
npx @ceum/cli --help
開始設定
從安裝到第一個命令,不到一分鐘。
安裝 CLI
使用 npm 全域安裝套件(Node.js 22 或更新版本)。
npm install -g @ceum/cli
登入
執行登入命令,並在提示時貼上權杖。它會安全地儲存在設定中。
ceum auth login
驗證
確認連線狀態——這會印出使用中的設定檔和端點。
ceum auth status
基本用法
每個資源都遵循相同的名詞優先語法,並可輸出為表格、JSON 或 CSV 以供管線串接。
列出進行中的任務,並用 jq 取出它們的名稱:
ceum tasks list --status in-progress -o json | jq '.data[].name'
一行建立一項任務:
ceum tasks create --name "Ship v1" --status todo
將所有交易匯出為 CSV:
ceum transactions list --all -o csv > all-transactions.csv
在 CI 中使用環境變數提供的權杖,以無頭模式執行:
CEUM_TOKEN=ceum_… ceum invoices list
實際輸出
來自 Ceum 工作區的真實輸出:終端機中對齊的表格,以及根據權杖權限推導出的命令清單。
您的工作區,就從提示列開始
與網頁和行動應用程式相同的工作區,由可預期的命令語法驅動。
名詞優先的命令
以資源開頭、可預期的語法——tasks list、time-sessions start、invoices create——用來驅動您的工作區。
為指令碼而生
以非互動方式執行命令,並將 Ceum 整合進您既有的自動化流程。
依您的方式輸出
以表格、JSON 或 CSV 取得結果,隨時可串接至下一個工具。
批次操作
一次處理多筆記錄,而非逐一點按。
底層採用 MCP
此 CLI 是建構於 Ceum 向外部工具開放的 Model Context Protocol 之上的輕量用戶端。
助手就緒
應用程式內的助理也由相同的操作驅動,因此撰寫指令碼與提問共用同一介面。
完整觸及工作區
客戶、專案、任務、時間、交易與發票——全都可從提示列存取。
文件完備的命令
每個命令都內建說明,並在知識庫中提供完整參考。