> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fased.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Health Checks

# Health Checks (CLI)

Short guide to verify Gateway and channel connectivity without guessing.

## Quick checks

* `fased status` — local summary: gateway reachability/mode, update hint,
  linked channel auth age, sessions, and recent activity.
* `fased status --all` — full local diagnosis. It is read-only, colored, and
  redacted where possible; still review before sharing.
* `fased status --deep` — also probes the running Gateway, including per-channel
  probes when supported.
* `fased health --json` — asks the running Gateway for a full health snapshot
  over WS.
* Send `/status` as a standalone message in WhatsApp/WebChat to get a status
  reply without invoking the agent.
* Logs: tail `/tmp/fased/fased-*.log` and filter for `web-heartbeat`,
  `web-reconnect`, `web-auto-reply`, or `web-inbound`.

## Deep diagnostics

* Creds on disk: `ls -l ~/.fased/credentials/whatsapp/<accountId>/creds.json`.
  The mtime should be recent.
* Session store: `ls -l ~/.fased/agents/<agentId>/sessions/sessions.json`.
  Config can override this path. Count and recent recipients are surfaced via
  `status`.
* Relink flow: use **Agent > Channels** for the normal WhatsApp QR/account flow.
  CLI repair is still available with `fased channels logout && fased channels
  login --verbose` when status codes 409–515 or `loggedOut` appear in logs.
  The QR login flow auto-restarts once for status 515 after pairing.

## When something fails

* `logged out` or status 409–515 → relink from **Agent > Channels**, or use
  `fased channels logout` then `fased channels login` for CLI repair.
* Gateway unreachable:
  * local profile / source dev → start it with `fased gateway run --port 18789 --bind loopback`
  * use `--force` if the port is busy
  * hosting profile / installed daemon → restart the managed service
  * keep the gateway on loopback; use Tailscale Serve, a tailnet path, or SSH
    for remote access
* No inbound messages → confirm linked phone is online and the sender is
  allowed. For group chats, ensure allowlist + mention rules match
  (`channels.whatsapp.groups`, `agents.list[].groupChat.mentionPatterns`).

## Dedicated "health" command

`fased health --json` asks the running Gateway for its health snapshot. It does
not open direct channel sockets from the CLI. It reports linked creds/auth age
when available, per-channel probe summaries, session-store summary, and probe
duration. It exits non-zero if the Gateway is unreachable or the probe fails or
times out. Use `--timeout <ms>` to override the 10s default.