Skip to main content

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

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:

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.