快速入门
在一分钟内上手 TokST。本指南将引导您完成安装、认证、创建第一个知识库和存储记忆。
智能体一键设置（最快方式）
复制以下消息，粘贴到您的 AI 智能体对话框中：
请阅读 https://tokst.com/skill.md 并按步骤安装 TokST 记忆技能。
先运行：curl -fsSL https://tokst.com/install.sh | bash
升级 CLI 时，安装程序会保留已有 TokST 连接。浏览器确认仅在首次连接或凭证失效时打开。
智能体会自动读取链接文档并自行安装独立 CLI、技能文件和 MCP 配置，然后完成浏览器授权。适用于 Claude Code、Cursor、Codex、ZCode 及任何兼容 MCP 的智能体。
完整指南请参阅智能体设置。
一键安装
安装 TokST 及所有依赖的最快方式：
curl -fsSL https://tokst.com/install.sh | bash
该脚本会下载通过 SHA-256 校验的 TokST 独立 CLI，打开浏览器授权，并让机器可以直接使用 tokst 命令。macOS 与 Linux 只需要 Unix 终端和 curl，Windows 使用 PowerShell。支持 macOS Apple Silicon、macOS Intel、Linux x64、Linux ARM64、Windows x64 与 Windows ARM64，无需安装 Bun、Node.js、npm 或包管理器。
Windows PowerShell：
irm https://tokst.com/install.ps1 | iex
Windows Git Bash 也支持 curl -fsSL https://tokst.com/install.sh | bash；脚本会识别 Windows 并交给同一套 PowerShell 安装器执行。
可随时按当前安装渠道升级。独立版下载校验后的二进制，npm 与 Bun 版更新各自的全局包：
tokst update
tokst version
浏览器授权
安装脚本会打开 TokST 浏览器页面并保存已验证的本地凭据。可随时验证：
tokst doctor
tokst status
API 密钥用于 CI、服务端和无人值守自动化，可在仪表盘创建和管理。
连接仓库与智能体
在任意目录运行以下命令。TokST 会为选定的智能体写入本地指令并保留已有文件。知识库创建和目录绑定使用独立命令。
tokst init --agents codex,claude,cursor,opencode,pi
tokst doctor
需要主动刷新生成的集成文件时使用 tokst init --force。tokst init 不依赖 Git 或云端访问。tokst doctor 会检查认证、可选的 Git 和知识库绑定，以及已生成的智能体文件。
创建您的第一个知识库
知识库是一个命名的知识库，用于保存相关记忆。创建一个：
tokst atlas init --name "MyKnowledge"
tokst atlas bind --atlas-id <id>
您可以列出知识库来确认：
tokst atlas list
存储您的第一条记忆
记忆是 TokST 中的核心信息单元。存储一条：
tokst remember "Hello TokST!" --type note
您可以通过类型对记忆进行分类：fact、decision、preference、task、architecture 或 note。
附加文件或图片来丰富您的记忆：
tokst remember "Meeting notes with diagram" --file diagram.png
批量导入
从文件夹批量导入文件为记忆 — 文本文件自动提取内容：
tokst import ./my-docs --dry-run # 先预览
tokst import ./my-docs --type note --tags imported # 带标签导入
搜索您的记忆
通过关键词或语义搜索查找记忆：
tokst search "hello"
要获得更丰富的结果，请使用额外筛选条件：
tokst search "deployment" --type decision --tags production --limit 10
检查状态
随时查看您的账户和使用详情：
tokst status
要获取机器可读的输出（适用于脚本）：
tokst status --json
MCP 服务器设置
要将 TokST 连接到支持 Model Context Protocol 的 AI 智能体（Claude Desktop、Cursor、Codex CLI），请将以下内容添加到您的 MCP 配置中：
{
"mcpServers": {
"tokst": {
"type": "streamable-http",
"url": "https://api.tokst.com/mcp"
}
}
}
MCP 客户端会打开 TokST 完成 OAuth 授权，无需本地运行环境。请参阅 MCP 服务器参考了解针对特定客户端的配置详情。
下载附件
如果记忆包含文件附件，可以将它们下载到本地：
tokst memory download mem_xxxxx # 所有附件 → ~/Downloads
tokst memory download mem_xxxxx --out ./files # 指定输出目录
tokst memory download mem_xxxxx --json # JSON 格式输出