Health

Check server status and availability.

Bridge Mode

curl http://localhost:9867/health# Response: {"status":"ok","tabs":1}

# CLI Alternative (human-readable by default)
pinchtab health
# Output: ok

pinchtab health --json              # Full JSON response

Bridge-mode health may also include:

• crashLogs
• failures
• crashes

In error cases it returns 503 with status: "error" and a reason.

Server Mode (Dashboard)

In full server mode, /health returns the dashboard health envelope:

curl http://localhost:9867/health

curl http://localhost:9867/health

{
  "status": "ok",
  "mode": "dashboard",
  "version": "0.8.0",
  "uptime": 12345,
  "authRequired": true,
  "profiles": 1,
  "instances": 1,
  "defaultInstance": {
    "id": "inst_abc12345",
    "status": "running"
  },
  "agents": 0,
  "restartRequired": false
}

Notes:

• defaultInstance is present when at least one instance exists
• use defaultInstance.status == "running" when you want to confirm Chrome is ready
• strategies such as always-on can create an instance automatically at startup

Related Pages

• Tabs
• Navigate
• Strategies