tools: add ppf-status cluster overview

2026-02-18 01:02:42 +01:00
parent 304830e382
commit 04fb362181
3 changed files with 255 additions and 0 deletions
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -42,6 +42,7 @@ tools/
  ppf-logs                     view container logs
  ppf-service                  manage containers (status/start/stop/restart)
  ppf-db                       database operations (stats/purge-proxies/vacuum)
+  ppf-status                   cluster overview (containers, workers, queue)
  playbooks/
    deploy.yml                 ansible playbook (sync, compose, restart)
    inventory.ini              hosts with WireGuard IPs + SSH key
@@ -107,6 +108,13 @@ ppf-db purge-proxies        # stop odin, delete all proxies, restart
 ppf-db vacuum               # reclaim disk space
 ```

+### Cluster Status
+
+```bash
+ppf-status                  # full overview: containers, DB, workers, queue
+ppf-status --json           # raw JSON from odin API
+```
+
 ### Direct Ansible (for operations not covered by tools)

 Use the toolkit inventory for ad-hoc commands over WireGuard: