Admin CLI

pgm-admin runs maintenance tasks that require direct administrative access.

What this page covers

Key lifecycle, schema-safe maintenance, and operational reprocessing commands.

Core workflow

1. Use repo wrapper when available:

./bin/pgm-admin key create --name local --scopes read,write,delete
./bin/pgm-admin stats

2. Manage keys and visibility:

• key create, key list, key revoke

3. Reprocess embeddings/extraction:

• reembed, reextract, improve-graph

4. Validate and prune graph quality:

• prune-edges --below <threshold>
• validate-edges

5. Run direct SQL/maintenance checks:

• pgm-admin sql "SELECT ...".

Notes

• Wrapper behavior:
  • docker exec when container is up
  • docker compose run --rm as fallback.
• --dry-run is available on most destructive commands.
• reextract resets extraction queue state without touching unrelated rows.