feat: add read-only JSON memory CLI for SSH/cron automation

README.md

@@ -10,6 +10,7 @@ The central nervous system for Erik's multi-project portfolio. A CLI (`pt`) and
 ./pt info          # Reference data (credentials, infrastructure)
 ./pt backup status # Full backup + off-machine backup health
 ./pt memory search "query"  # Cross-agent shared memory
+PT_SKIP_DOPPLER=1 ./pt memory recent --since 7d --json  # Read-only cron/SSH memory query
 ./pt sync status   # Replication status / pause / resume controls
 ./pt sync check    # Mini-local sync rollout readiness check
 ./pt sync set-machine-id 883  # Persist explicit machine identity for sync
@@ -20,6 +21,7 @@ The central nervous system for Erik's multi-project portfolio. A CLI (`pt`) and
 - **Kanban** — Task management across all projects (`pt tasks`)
 - **Dashboard** — Project health, GitHub activity, memory graph visualization
 - **Memory** — Cross-agent semantic search via Open Brain (`pt memory`)
+- **Automation** — Read-only JSON memory commands for SSH/cron integrations (`pt memory recent --json`, `pt doctor --json`)
 - **Info** — Centralized reference store for env vars, credentials, infrastructure (`pt info`)
 - **Graph** — D3.js visualization of file relationships across the ecosystem
 - **Sync Controls** — Replication pause/resume/status plus Mini-local readiness checks for Phase 2 (`pt sync`)

USAGE.md

@@ -30,6 +30,8 @@ You can configure the behavior of Project Tracker using these environment variab
 | `PT_FULL_BACKUP_DIR` | Directory for full `tracker_*.db` snapshot backups. | `~/.project-tracker/backups/` |
 | `PT_BACKUP_LOG_PATH` | Backup job log consumed by `pt backup status` and the dashboard. | `~/.project-tracker/backup.log` |
 | `PT_BACKUP_RCLONE_DEST` | Optional rclone destination for one off-machine full backup per day. | unset |
+| `PT_MEMORY_DB_PATH` | Optional override for read-only `pt memory` JSON commands. | `$PROJECTS_ROOT/ai-memory/brain.db` |
+| `PT_SKIP_DOPPLER` | Set to `1` for read-only SSH/cron commands that should not invoke Doppler. | `0` |
 
 ---
 
@@ -155,6 +157,22 @@ Click **"Details"** to see:
 ./pt sync pause --all
 ```
 
+### Read-Only Memory Automation
+
+Use these commands from SSH `BatchMode` sessions, cron jobs, or service users that need memory data without touching databases directly:
+
+```bash
+cd $PROJECTS_ROOT/project-tracker
+PT_SKIP_DOPPLER=1 ./pt memory search --query "LoopLens" --since 7d --limit 50 --json
+PT_SKIP_DOPPLER=1 ./pt memory recent --since 7d --project project-tracker --limit 50 --json
+PT_SKIP_DOPPLER=1 ./pt memory stats --json
+PT_SKIP_DOPPLER=1 ./pt memory export --format ndjson --since 7d --limit 500
+PT_SKIP_DOPPLER=1 ./pt config show --effective --json
+PT_SKIP_DOPPLER=1 ./pt doctor --json
+```
+
+JSON responses include a `schema_version`, `ok`, `read_only`, backend metadata, filters, pagination, and result rows. JSON mode does not mix prose into the payload. Validation errors exit `2`; backend/readiness failures exit `3`; query failures exit `4`.
+
 ---
 
 ## 🔄 How Data is Collected