Skip to main content

Sync a workspace over git

The simplest cross-device / backup path - your memory is just files, so git moves them:
pmb workspace init --remote git@github.com:me/pmb-memory.git
pmb workspace push      # back up / share
pmb workspace pull      # on another machine
pmb workspace status
For a public remote, encrypt into one portable bundle:
pip install 'pmb-ai[crypto]'
pmb workspace export memory.pmb        # scrypt + AES/HMAC
pmb workspace import memory.pmb team   # decrypt into a local workspace

Shared HTTP server (team mode)

Expose one warm server to remote agents:
pmb mcp serve --transport streamable-http --host 0.0.0.0 --bearer-token <secret>
Team mode is the only mode that should listen beyond localhost. The bearer token is the boundary - set PMB_MCP_BEARER_TOKEN and put the server behind a private network (Tailscale) or an SSH tunnel.

Point several agents at one memory

pmb connect claude-code --workspace personal
pmb connect cursor      --workspace personal
# both read/write the same workspace; SQLite WAL handles concurrent writes