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 历史或长期记忆。