Skip to main content

/gws-status

Read-only health report for the current GWS environment. Type /gws-status inside your AI agent and it will summarize pod state, file-sync sessions, and HTTP probe results without changing anything.

When to use it​

  • You want a quick "is everything healthy?" check before continuing work
  • You suspect a service is misbehaving and want a structured snapshot before debugging
  • You want a summary without restarting or redeploying anything

What it does​

  1. Fetches structured status — gws status --json.
  2. HTTP-probes every URL — performs GET <url> for each HTTP service and captures status code or connection error.
  3. Summarizes — produces a structured report:
    • Overall: healthy (all Running, all 2xx, all file-sync Watching), partial (some failures), or down (no services Running).
    • Per service: pod phase, restart count, URL probe result, file-sync state.
    • Recent restarts: services with restarts > 0 in the last hour are flagged as suspicious.
  4. Suggests next actions — for each unhealthy service:
    • Pod failing → run gws logs <svc>
    • URL not responding but pod Running → likely gateway hostname/port mismatch; try /gws-debug
    • High restart count → invoke /gws-debug
    • File-sync Halted* → reset with gws down -y && gws up -y

See also​