User CLI

pgm is the standard client for human and agent workflows.

What this page covers

Primary command groups and common flags.

Reference

Setup

export PGM_API_URL=http://127.0.0.1:3100
export PGM_API_KEY=...

Common commands

• store (write entity)
• search (compact JSON, TOON, or full response)
• recall, list, update, delete
• expand
• task add/list/update/complete
• sync
• link / unlink / expand
• backup
• groom (session-context maintenance)
• queue (enrichment queues)

Output options

• --json: compact machine-friendly output.
• --json --full-response: REST-shaped payload.
• --toon: compact human-readable text for list-like output.

Notes

• Install from npm:

npm install -g @ivotoby/postgram-cli

• In-development execution:

npx tsx cli/src/pgm.ts <command>