# 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.

```sh
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:

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

## Files, backups, and MCP

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

Configure a local stdio MCP client with:

```json
{
  "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:

```sh
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.