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