> ## 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.

# Auth Monitoring

# Auth monitoring

Fased exposes model-provider auth health through the CLI. That is the source of
truth for scheduled tasks, systemd timers, shell scripts, and external monitors.

## Preferred check

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
fased models status --check
```

Exit codes:

* `0`: credentials look healthy
* `1`: credentials are missing or already expired
* `2`: credentials are close to expiry, currently inside the default 24-hour
  OAuth warning window

This is the best automation surface because it stays portable across local
setups, hosted gateways, cron, and systemd.

If you need richer output, use:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
fased models status --json
```

## Optional Claude-oriented scripts

The helper scripts under `scripts/` are convenience layers for personal Claude
Code and Fased auth ops flows. The standard provider-aware monitoring path is
`fased models status --check`.

* `scripts/claude-auth-status.sh`
  * reads `fased models status --json` first
  * falls back to direct file inspection only if the CLI is unavailable
* `scripts/auth-monitor.sh`
  * Claude Code expiry wrapper for local alerts or phone notifications
* `scripts/systemd/fased-auth-monitor.{service,timer}`
  * user-level systemd timer units
* `scripts/mobile-reauth.sh`
  * guided SSH re-auth flow
* `scripts/termux-quick-auth.sh`
  * compact Termux widget helper
* `scripts/termux-auth-widget.sh`
  * fuller guided Termux flow
* `scripts/termux-sync-widget.sh`
  * sync helper for Claude Code credentials into Fased

For normal monitoring, use `fased models status --check` directly.