tilt

# Tilt ## First Action: Check for Errors Before investigating issues or verifying deployments, check resource health: ```bash # Find errors and pending resources (primary health check) tilt get uiresources -o json | jq -r '.items[] | select(.status.runtimeStatus == "error" or .status.updateStatus == "error" or .status.updateStatus == "pending") | "\(.metadata.name): runtime=\(.status.runtimeStatus) update=\(.status.updateStatus)"' # Quick status overview tilt get uiresources -o json | jq '[.items[].status.updateStatus] | group_by(.) | map({status: .[0], count: length})' ``` ## Non-Default Ports When Tilt runs on a non-default port, add `--port`: ```bash tilt get uiresources --port 37035 tilt logs <resource> --port 37035 ``` ## Resource Status ```bash # All resources with status tilt get uiresources -o json | jq '.items[] | {name: .metadata.name, runtime: .status.runtimeStatus, update: .status.updateStatus}' # Single resource detail tilt get uiresource/<name> -o json # Wait for ready tilt wait --for=condition=Ready uiresource/<name> --timeout=120s ``` **Status values:** - RuntimeStatus: `ok`, `error`, `pending`, `none`, `not_applicable` - UpdateStatus: `ok`, `error`, `pending`, `in_progress`, `none`, `not_applicable` ## Logs ```bash tilt logs <resource> tilt logs <resource> --since 5m tilt logs <resource> --tail 100 tilt logs --json # JSON Lines output ``` ## Trigger and Lifecycle ```bash tilt trigger <resource> # Force update tilt up # Start tilt down # Stop and clean up ``` ## Critical: Never Restart for Code Changes Tilt live-reloads automatically. **Never suggest restarting `tilt up`** for: - Tiltfile edits - Source code changes - Kubernetes manifest updates Restart only for: Tilt version upgrades, port/host changes, crashes, cluster context switches.