智能体设置

在一分钟内为任何 AI 智能体配备 TokST 持久记忆。

浏览器设置（推荐）

本地 CLI 或桌面智能体使用一条命令即可开始。安装器会下载独立 TokST CLI，然后打开浏览器授权：

curl -fsSL https://tokst.com/install.sh | bash

Windows PowerShell 使用：

irm https://tokst.com/install.ps1 | iex

TokST 会打开浏览器，确认已登录账户，并在本机保存凭据后执行连接验证。工作区与知识库范围继续由每条命令、MCP 工具调用或可选的目录绑定明确指定。

一键设置

复制以下消息，粘贴到智能体的对话框中：

请阅读 https://tokst.com/skill.md 并按步骤安装 TokST 记忆技能。
先运行：curl -fsSL https://tokst.com/install.sh | bash

智能体会读取链接文档并完成对应的设置步骤：

1. 运行 curl -fsSL https://tokst.com/install.sh | bash
2. 完成浏览器授权
3. 在任意目录运行 tokst init --agents <agent> 写入智能体指令；需要项目路由时再单独创建并绑定知识库
4. 支持 Skills 的客户端将 tokst-memory 放入自己的 skills 目录
5. 使用上下文与结构化 Markdown 开始记录记忆

如果你的智能体无法直接访问链接，先下载文档：

curl -fsSL https://tokst.com/skill.md -o SKILL.md

然后告诉智能体：阅读 SKILL.md 并按步骤安装。

内置版本检查——重新读取该链接即可自动更新到最新版本。

技能文件是无状态的。所有记忆数据存储在 TokST 云端，不在这些文件中。更新技能永远不会影响你的数据。

支持哪些智能体？

将 skill.md 以 SKILL.md 的名称放入目标智能体使用的目录：

手动设置

全新电脑使用安装脚本即可开始。它需要 Unix 终端和 curl；macOS、Linux 和 WSL 的标准环境均已提供。

# 安装独立 CLI，然后完成浏览器授权
curl -fsSL https://tokst.com/install.sh | bash
tokst doctor

# 验证
tokst status

第 2 步：安装技能文件

最简单的方式是使用上面的一键设置——将消息粘贴到智能体对话框，它会自动完成安装。

如需手动安装，使用一键设置脚本而非逐个下载文件：

第 3 步：添加 MCP（可选）

TokST 支持 Claude Code、Codex、Pi、WorkBuddy、ZCode、Qoder、Kimi 及其他 MCP 客户端。支持 OAuth 的客户端可直接连接云端端点，客户端会打开 TokST 完成授权，无需本地运行环境。仅在远端服务需要聚焦的 11 个核心记忆工具时设置 TOKST_MCP_TOOLSET=core：

{
  "mcpServers": {
    "tokst": {
      "type": "streamable-http",
      "url": "https://api.tokst.com/mcp"
    }
  }
}

WorkBuddy、ZCode、Qoder、Kimi 等使用静态配置的客户端可通过专用 API 密钥连接。在仪表盘 API 密钥创建密钥后，填写以下 Streamable HTTP 配置：

{
  "mcpServers": {
    "tokst": {
      "type": "streamable-http",
      "url": "https://api.tokst.com/mcp",
      "headers": {
        "Authorization": "Bearer tk_live_your_api_key"
      }
    }
  }
}

每个客户端使用独立密钥；停止使用后可在仪表盘中撤销对应密钥。

需要本地进程的客户端可在执行安装脚本后继续使用本地 stdio MCP。

仪表盘快捷方式

在仪表盘创建 API 密钥时，创建弹窗会显示：

• 可直接复制的 SKILL.md（内嵌你的密钥）
• 快速安装脚本（一键粘贴到终端）
• MCP 配置 JSON
• 每个密钥旁的 Copy for Agent 按钮

你也可以直接分享 https://tokst.com/skill.md——智能体会自行处理其余步骤。

验证是否正常工作

# 检查 CLI 连接
tokst status

# 检查技能文件已安装（根据你的智能体调整路径）
head -5 ~/.claude/skills/tokst-memory/SKILL.md
# 应显示: --- name: tokst-memory ... version: 0.8.3 ---

# 存储一条测试记忆
TOKST_AGENT=1 tokst remember "智能体设置完成" --type note --json

# 搜索它
TOKST_AGENT=1 tokst search "智能体设置" --json

# 可选：一次启用自动记忆桥接器
tokst auto on --agent all
tokst acp proxy -- <acp-agent-command> [args]
tokst auto status

OpenCode 终端、App 与 ACP

OpenCode 终端与 macOS App 重启一次后会加载 TokST 全局插件。opencode 新建的会话和 opencode -s 恢复的会话都会映射到同一个 TokST Session，并更新同一条自动记忆。ACP 兼容编辑器或 IDE 也可通过 TokST 启动 OpenCode。

tokst auto on --agent opencode
tokst acp opencode --doctor

将以下智能体命令配置到 ACP 客户端：

{
  "command": "tokst",
  "args": ["acp", "opencode"]
}

tokst auto repair --agent opencode 会按当前 TokST 可执行文件绝对路径重新生成全局插件。tokst acp opencode --repair 保留 ACP Host 修复流程。

Pi、Codex、Claude Code 与 Claude Desktop

一次启用后重启所使用的客户端。Pi 使用全局扩展；Codex 与 Claude Code 安装 TokST 托管 Hook，并保留所有用户已有 Hook。原生会话会映射到同一个 TokST Session，恢复同一会话时持续更新对应自动记忆。

tokst auto on --agent pi,codex,claude
tokst auto verify --agent pi,codex,claude --json
tokst acp pi --doctor

Claude Desktop 通过 TokST MCP 扩展提供辅助记忆、检索、会话生命周期和撤销能力。它显示为“辅助记录”，不显示为自动采集。

常见问题

完整 CLI 参考：CLI 命令