快速入門
在一分鐘內上手 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 格式輸出