TokST Persistent memory for people and AI agents

TokST Help Center

Resolve the next step quickly

Search an error, command, or workflow. Each guide provides the checks, recovery path, and proof that it worked.

Install & update

tokst: command not found

Install the standalone CLI and refresh the terminal PATH.

  1. Run the platform installer.
  2. Open a new terminal.
  3. Confirm the selected binary.
curl -fsSL https://tokst.com/install.sh | bash

Read the full guide

Install & update

The version remains old after update

Refresh the standalone binary and identify the command selected by the shell.

  1. Run the built-in updater.
  2. Open a new terminal.
  3. Inspect the active binary path.
tokst update

Read the full guide

Sign in & connection

Browser authorization did not return

Restart browser authorization while the terminal process remains open.

  1. Keep the terminal flow open.
  2. Start setup again.
  3. Confirm cloud access after approval.
tokst setup

Read the full guide

Sign in & connection

API key or permission request failed

Confirm the saved identity, target workspace, and key owner permissions.

  1. Check the active cloud connection.
  2. Review accessible workspaces.
  3. Create or rotate the trusted API key in the dashboard.
tokst connection test

Read the full guide

Local mode

Local write returns a SQLite error

Preserve the local database, update the CLI, then collect profile status.

  1. Update the standalone CLI.
  2. Create a named backup before repair.
  3. Collect the local profile status.
tokst update
tokst local backup create --name before-repair

Read the full guide

Local mode

Local memory has not appeared in Cloud

Local sync starts only after an explicit Local Atlas to Cloud Atlas binding.

  1. Inspect the Local profile.
  2. Connect the intended Cloud Atlas.
  3. Run the manual sync.
tokst local status
tokst local connect --cloud-atlas-id <atlas-id>

Read the full guide

Workspaces & Teams

Workspace or Atlas creation is unavailable

Creation follows the current personal or Team plan limits.

  1. Inspect your current plan and usage.
  2. Switch to the intended workspace.
  3. Create the space within its available limit.
tokst status

Read the full guide

Workspaces & Teams

A Team invitation is missing

The recipient reviews and accepts invitations from their own account.

  1. Confirm the invitee email address.
  2. Review the recipient inbox.
  3. Accept the active invitation before team access starts.
tokst workspace inbox

Read the full guide

MCP & Agents

MCP tools do not appear

Authorize the machine that runs local MCP, then restart the MCP client.

  1. Confirm the saved cloud connection.
  2. Refresh generated Agent integration files.
  3. Restart the MCP client.
tokst connection test
tokst init --agents codex,claude,cursor,opencode,pi --force

Read the full guide

MCP & Agents

WorkBuddy, ZCode, Qoder, or Kimi cannot open browser authorization

Use a dedicated API key in a Streamable HTTP MCP Authorization header.

  1. Create a dedicated API key named for the client.
  2. Set the client transport to Streamable HTTP.
  3. Paste the complete key after Bearer and restart the client.
{
  "mcpServers": {
    "tokst": {
      "type": "streamable-http",
      "url": "https://api.tokst.com/mcp",
      "headers": { "Authorization": "Bearer tk_live_your_api_key" }
    }
  }
}

Read the full guide

MCP & Agents

Agent messages are missing

Use the persistent inbox after restarts and a listener beside long-running Agents.

  1. Confirm the trusted Agent identity.
  2. Synchronize the persistent inbox.
  3. Run the listener for immediate delivery.
TOKST_AGENT=1 tokst message inbox --json

Read the full guide

MCP & Agents

Automatic memory did not appear

ACP automatic memory creates one revocable Markdown memory when the connected Agent session closes. Explicit Session capture remains available for confirmed conclusions.

  1. Enable automatic memory for the default route.
  2. Launch the ACP-compatible Agent through the TokST proxy.
  3. Check the connection and queue state.
  4. Review the linked Session or archive its automatic memory when needed.
tokst auto on
tokst acp proxy -- <acp-agent-command> [args]
tokst auto status

Read the full guide

Files & quota

A file or its memory association is missing

Review the Files recycle bin and verify the target workspace and memory lifecycle.

  1. Open Files for the selected workspace.
  2. Review the recycle bin and orphan repair results.
  3. Restore the memory or file association when available.
tokst status

Read the full guide

Files & quota

Upload or request reached a quota

Usage belongs to the selected personal or Team workspace.

  1. Inspect plan and available usage.
  2. Confirm the selected workspace.
  3. Ask the Team Owner to adjust team capacity when needed.
tokst status --json

Read the full guide