TokST Local

TokST Local keeps private memory on the current device with SQLite and FTS5. It runs on macOS, Linux, and Windows through the same CLI, MCP package, npm package, and binary release system used by TokST Cloud.

tokst setup --local
tokst local remember "Keep this on this Mac" --tags private
tokst local search "private"
tokst local context

The installer chooses the platform binary. npm users can keep using @tokst/cli and @tokst/mcp-server.

Data is stored in the platform application-data directory:

tokst.sqlite
attachments/
backups/
local-profile.json

Files, backups, and MCP

tokst local remember "Contract" --file ./contract.pdf
tokst local backup create --name before-upgrade
tokst local mcp

Configure a local stdio MCP client with:

{
  "mcpServers": {
    "tokst-local": {
      "command": "tokst",
      "args": ["local", "mcp"]
    }
  }
}

Optional cloud sync

Cloud sync remains opt-in and binds one local Atlas to one cloud Atlas:

tokst login --key tk_live_xxxx
tokst local connect --cloud-atlas-id <cloud-atlas-id>
tokst local sync

Sync transfers memory content, metadata, status, and tags. Attachments remain on the current device in this release. Concurrent local and cloud edits are retained as separate conflict memories, so neither edit is overwritten.