Skip to main content

/gws-up

Start the GWS environment for the current project. Type /gws-up inside your AI agent and it will deploy, verify, and report.

When to use it​

  • You want to start a previously-set-up project without manually checking pod health afterwards
  • You want a single command that "starts and confirms it's actually working"

What it does​

  1. Confirms the project is registered — runs gws status. If the project isn't registered with the API, it stops and tells you to run /gws-setup first.
  2. Brings the environment up — gws up -y (non-interactive).
  3. Reports deployment status — calls gws status --json and parses per-service pod state (Running, Pending, CrashLoopBackOff), restart counts, service URLs, and file-sync session state.
  4. HTTP-probes every URL — for each gateway-routed service URL, performs a GET and reports the status code or connection error.
  5. Hands off on failure — if any service is unhealthy or any URL fails to respond, suggests /gws-debug.

See also​