Skip to main content

gws status

Display the status of worktrees and cluster.

Usage​

gws status [options]

Output:

ℹ ────────────────────────────────────────────────────────────────────────────────
ℹ 🌍 Project: myapp
ℹ ────────────────────────────────────────────────────────────────────────────────

ℹ    Worktree: default
ℹ    Status:     ✅ running
ℹ    Namespace:  myapp
ℹ    Path:       /path/to/myapp
ℹ    Branch:     main

ℹ 🔧 Services
ℹ    ✅ api-5954f5fb9d-fpvbj: Running
ℹ    ✅ app-6bccf88cfd-7vx88: Running

ℹ 📁 File Syncs
ℹ    ✅ myapp-default-api: watching
ℹ       Local:  /path/to/myapp/api
ℹ       Remote: /app
ℹ    ✅ myapp-default-app: watching
ℹ       Local:  /path/to/myapp/app
ℹ       Remote: /app

ℹ 👁️  Watch Sessions
ℹ    No active watch sessions

ℹ 🔌 Expose Sessions
ℹ    ✅ mysql: localhost:3306 → myapp:3306
ℹ       Status: running

ℹ 🌐 HTTPRoutes:
ℹ    • https://api.myapp.local.getwebstack.dev:9443/
ℹ    • https://app.myapp.local.getwebstack.dev:9443/

ℹ ⏰ Timestamps:
ℹ Created: 4/1/2026, 11:21:27 AM
ℹ
ℹ Last started: 4/1/2026, 11:21:27 AM

Note: This command can be run from anywhere using the -p [project] option.

Options​

OptionDescriptionDefault
-w, --worktree <name>Specific worktree to checkMain project deployment
-p, --project <name>Project nameAuto-detected from current directory
--allDisplay status for all projects and all worktreesfalse
--jsonOutput as JSONfalse

Examples:

# Check specific worktree
gws status -w feature-auth

# JSON output
gws status --json

Status Information​

The status command provides:

  1. Worktree Info — name, status, namespace, local path, and git branch
  2. Services — Kubernetes pod names and running state
  3. File Syncs — active sync sessions with local and remote paths
  4. Watch Sessions — active file watchers for auto-rebuilds
  5. Expose Sessions — localhost tunnels to cluster services
  6. HTTPRoutes — all accessible HTTPS URLs for the deployment
  7. Timestamps — when the worktree was created and last started

Typical Use Cases​

# Quick check before starting work
gws status

# Verify deployment after gws up
gws up && gws status

# Export for CI/CD
gws status --json > deployment-status.json

See Also​