Skip to main content

​
Own your data

​
pmb export [--format markdown | json] [--out FILE]

Dump all memory to readable text (--include-archived). Plain, unencrypted.

​
pmb delete <ulid...> / pmb forget <ulid>

Archive one or more memories after a preview + confirmation (reversible). Add --hard to delete to permanently purge memories, vectors, and graph links.

​
pmb restore <ulid>

Restore a soft-deleted or archived memory.

​
pmb forget-topic <topic>

Archive everything about a topic in one command. --dry-run, --yes, --in content|tag|source.

​
pmb pin <ulid>

Pin a memory (max importance, never auto-archived).

​
pmb tag <ulid> <tags...> / pmb untag

Tag / untag a memory for local organization.

​
pmb ttl <ulid> 30d | clear · pmb prune-expired

Set/clear an expiry; archive memories past their TTL (run from cron).

​
pmb snapshot create | list | verify | restore

Local snapshots with SQLite online backup and SHA-256 file manifests. verify <id> checks integrity without restoring; list --json prints metadata. Stop PMB servers, agents, and dashboards before restoring. Restore validates first, saves a verified safety copy, replaces stale files, and rolls back file moves on an I/O error. Legacy snapshots have no file checksums.

​
pmb decay · pmb dedupe · pmb compact

Apply the forgetting curve; deduplicate (offline cosine by default; --run-pending uses an LLM for borderline pairs ); move old archived events to cold storage + VACUUM.

​
Sync & backup

These are the only commands that touch the network - and only when you run them. Everything else is fully local.

​
pmb workspace init [--remote URL]

Turn the workspace into a git repo.

​
pmb workspace push | pull | status

Sync memory to/from a git remote (cross-device, team, backup).

​
pmb workspace clone <url> <name>

Clone a remote workspace locally.

​
pmb workspace export <out> [--key-file] / import <bundle> <name>

Encrypt the workspace into one portable bundle (scrypt + AES/HMAC) - safe even on a public remote - and decrypt it back. Needs pip install 'pmb-ai[crypto]'.

​
pmb workspaces

List all known workspaces.