Skip to main content

Operator reference

CLI and operations.

Examples for administrators of an SPM installation. Hosted users can start in the dashboard without running deployment or launch commands.

Updated September 30, 2026

← Quickstart

These are independent examples, not a script to run in sequence. Replace placeholders and use evidence from your own environment. Commands that record, create, share or deploy change state and require the corresponding permissions.

Connect and verify
spm signing status
spm bundle verify --json
export SPM_API_URL=http://localhost:8000
export SPM_API_KEY=<api-token>
spm init --api $SPM_API_URL --project <project-id>
spm mcp tools --allow-tool spm_saved_searches_list --allow-tool spm_activity_recent --allow-tool spm_runs_list --json
Memory and maintenance
spm temporal state --topic release-readiness --limit 50
spm temporal context-pack create --action-name agent_handoff --topic release-readiness --tags mcp,agent
spm memory-agent maintenance run --topic release-readiness --min-confidence 0.8
spm memory-agent maintenance reviews list --status pending
Benchmarks
spm benchmark run --max-projects 2 --json
spm benchmark run --max-projects 1 --llm-judge --llm-max-tasks 1 --json
spm benchmark runs --limit 5 --json
spm benchmark trend --limit 20 --json
spm benchmark trend --limit 20 --out spm-memory-benchmark-trend.zip
spm benchmark policy-create --name daily-evidence --schedule '0 6 * * *' --run-now --json
spm benchmark policies-run-due --limit 5 --json
spm benchmark evidence <run-id> --json
spm benchmark evidence <run-id> --out spm-memory-benchmark-evidence.zip
Launch evidence
spm launch agent-recipes --json
spm launch agent-connector-export --project-id <project-id> --agent-kind codex --api-base-url https://getspm.com --query 'current project memory for an agent handoff' --tag agent --out spm-agent-connector.zip --json
spm launch readiness --json
spm launch readiness-export --out spm-release-readiness.zip
spm launch operations --json
spm launch operations-export --out spm-launch-operations.zip
spm launch revenue-readiness --json
spm launch revenue-readiness-export --out spm-revenue-readiness.zip
spm launch buyer-journey --json
spm launch buyer-journey-export --out spm-buyer-journey.zip
spm launch outreach-record --prospect-label design-partner-a --use-case 'Agent teams need governed project memory before mutating production code' --segment technical_team --pain-point 'requirements drift between agents' --route commercial_invite --next-action 'send governed trial invite' --json
spm launch outreach --json
spm launch outreach-export --out spm-outreach-report.zip
spm launch activation --json
spm launch activation-events --limit 20 --json
spm launch activation-export --out spm-trial-activation.zip
spm launch pilot-cohort-create --cohort-label memory-pilot-alpha --objective 'Validate SPM temporal memory, verified context packs and governed sharing against real agent work' --competitor-ref label=mem0,status=ready,report_hash=<hash> --claim-ref label=public-claim-readiness,status=ready,report_hash=<hash> --json
spm launch pilot-cohorts --limit 20 --json
spm launch pilot-cohort-report --json
spm launch pilot-cohort-export --out spm-pilot-cohort-report.zip
spm launch external-evidence-room --json
spm launch external-evidence-export --out spm-external-evidence-room.zip
spm launch external-approval-record --source-label design-partner-a --approved-by design-partner-legal --reference-hash <sha256> --scope 'Reference pilot outcomes in sales conversations' --claim-level commercial_claim --public-quote --case-study --dpa-reviewed --json
spm launch external-approvals --limit 5 --json
spm launch external-approval-export <approval-id> --out spm-external-evidence-approval.zip
spm launch market-dossier --json
spm launch market-dossier-export --out spm-market-readiness-dossier.zip
spm launch restore-drill-record --environment production-staging --target spm-restore-drill-isolated-db --backup-uri s3://spm-backups/postgres/spm.sql.gz --backup-sha256 <sha256> --started-at 2026-05-19T10:00:00Z --finished-at 2026-05-19T10:12:00Z --json
spm launch restore-drills --limit 5 --json
spm launch restore-drill-export <drill-id> --out spm-restore-drill.zip
spm launch monitoring-record --environment production --base-url https://getspm.com --route slack:high:pass:ops-alerts:<fingerprint> --credential-secret-ref SPM_ALERT_WEBHOOK_URL --otel-tracing-configured --json
spm launch monitoring-evidence --limit 5 --json
spm launch monitoring-export <evidence-id> --out spm-monitoring-evidence.zip
spm launch production-probe --environment production --base-url https://getspm.com --platform self_hosted_vps --shared-host --shared-host-preflight-hash <preflight-hash> --http-port 3500 --https-port 3543 --version 2026-05-19 --json
spm launch production-record --environment production --base-url https://getspm.com --platform self_hosted_vps --http-port 3500 --https-port 3543 --version 2026-05-19 --json
spm launch production-evidence --limit 5 --json
spm launch production-export <evidence-id> --out spm-production-evidence.zip
spm launch visual-qa-record --report docs/visual-qa-report.json --environment production --premium-visual-reviewed --json
spm launch visual-qa-evidence --limit 5 --json
spm launch visual-qa-export <evidence-id> --out spm-visual-qa-evidence.zip
spm launch pilot-record --pilot-name design-partner-memory --customer-label design-partner-a --segment enterprise --use-case 'Validate temporal memory, context injection and verified context packs in an agent handoff workflow.' --criterion 'Recover original requirements without drift' --criterion 'Inject only relevant temporal context' --outcome agent_handoff_rework_reduction:pass:32:20:percent:pilot-report --sharing-validated --external-ref-label customer-approved-pilot-report --external-ref-hash <sha256> --json
spm launch pilot-evidence --limit 5 --json
spm launch pilot-validation --limit 20 --json
spm launch pilot-validation-export --out spm-pilot-validation-report.zip
spm launch pilot-export <evidence-id> --out spm-pilot-evidence.zip
Deployment
spm deploy preflight --mode shared-host --host <server-ip> --identity-file ~/.ssh/id_2020_rsa --json
spm deploy shared-env --http-port 3500 --https-port 3543