CLI 參考
tokst 是進階設備工具，用於連接本機智能體端點、查看執行狀態、執行明確會話和任務操作。智能體透過雲端 MCP 處理記憶、檢索、上下文與記憶治理。
開始使用
tokst login
tokst start
tokst auto on --agent all
tokst status
tokst doctor
login 在瀏覽器中授權目前裝置，並建立最小本機憑據設定。start 連接裝置並啟動本機服務。auto on 由使用者明確啟用自動工作階段擷取並安裝所選橋接器。status 按工作區顯示目前裝置、連線狀態與可執行智能體；auto status 顯示自動擷取與橋接器診斷。doctor 顯示連接與整合問題的修復操作。
設備命令
| 命令 | 用途 |
|---|---|
tokst login | 在瀏覽器中授權目前裝置 |
tokst start | 連接目前裝置並啟動本機服務 |
tokst stop | 停止已連線裝置服務和自動擷取 |
tokst auto on --agent <name|all> | 安裝指定橋接器並啟用自動工作階段擷取 |
tokst auto off [--agent <name|all>] | 關閉自動擷取，同時保留已連線裝置 |
tokst status [--json] | 查看目前裝置及其在可存取工作區中的智能體狀態 |
tokst auto status | 查看自動擷取與橋接器診斷 |
tokst doctor [--fix-path] | 診斷本機整合與連接問題 |
tokst logs [--agent <name>] | 查看本機橋接與任務診斷 |
tokst update | 按目前安裝渠道升級 CLI |
tokst --help 顯示精簡命令清單。使用 tokst <群組> --help 查看 session、task 和 agent 的完整說明。
本機目錄規則
安裝階段僅寫入已驗證二進位檔和 PATH。login 建立
~/.tokst/config.json；start 依需求建立私有服務佇列和日誌。每個已建立智能體使用獨立的
~/.tokst/workspace/bindings/<binding-id>/work/ 工作目錄。專案目錄由使用者明確選擇，雲端只接收路徑雜湊。
只有 tokst init 會在專案內建立 .tokst/、智慧體指引或專案 MCP 設定。
會話
會話用於保存需要重要檢查點、證據或長期結果的一段工作。支援的端點橋接器也會從自動活動產生會話記錄。
tokst session start --task "檢查部署準備情況" --json
tokst session capture --session <session-id> "已驗證預發布清單" --json
tokst session checkpoint --session <session-id> "等待部署核准" --json
tokst session finalize --session <session-id> "核准已完成" --json
tokst session list --json
tokst session candidates --json
會話保留有意義的證據與診斷。tokst session candidates 在相容期內列出既有審核候選。長期記憶和共享上下文持續透過雲端 MCP 使用。
任務
在用戶後台建立和分派正式任務。CLI 可從已驗證設備或端點查看和控制任務。
tokst task list --json
tokst task show <task-id> --json
tokst task claim <task-id> --endpoint <endpoint-id> --json
tokst task cancel <task-id> --reason "不再需要" --json
tokst task retry <task-id> --endpoint <endpoint-id> --mode automatic --json
任務命令保留分派、領取、執行、結果、取消與重試稽核。任務建立、多端點分派、審核與封存於用戶後台完成。
工作區與知識庫治理
使用者透過後台管理，智能體透過雲端 MCP 操作工作區與知識庫。雲端 MCP 提供完整受治理操作，包括封存與復原；CLI 與共享資料保持邊界，只負責設備 Runtime。
Runtime 投遞與溝通
tokst start 維護任務投遞與溝通共用的驗證 WSS 連線。Runtime 將事件路由到所選智能體綁定，處理離線佇列，串流回寫回覆活動，並透過 Server 儲存最終結果。
tokst status --json
tokst doctor
tokst logs
長期私訊與智能體群組使用儀表板 -> 溝通。明確指派工作使用儀表板 -> 任務。TOKST_AGENT=1 或 --agent 繼續提供受限機器可讀診斷；使用 --full 取得完整 JSON。
已退役的本機模式
TokST 本機模式已退役。既有裝置檔案繼續保留；CLI 不再開啟、匯出、復原、同步或提供 Local SQLite 設定。已連線 Runtime 裝置只保留內部加密佇列，用於去識別投遞復原。請查看 TokST 本機模式已退役。
記憶介面
https://api.tokst.com/mcp 是記憶、檢索、上下文、檔案、工作區與知識庫的唯一現行介面。記憶工具請查看MCP 參考，接入方式請查看智能體接入。
驗證與升級
curl -fsSLo tokst-install.sh https://tokst.com/install.sh
sh tokst-install.sh
tokst login
tokst version --verbose
tokst update
CI 或無人值守服務使用受保護設定中的專用 API Key：
tokst login --key tk_live_your_api_key
tokst connection test
tokst logout
請勿將 API Key、私鑰、Cookie 或 token 寫入原始碼、Shell 歷史或長期記憶。