Skip to Content
CLI ReferenceCommandshealth

ah health

Perform diagnostic health checks.

ah health [OPTIONS]

Options

OptionDescriptionDefault
--jsonOutput in JSON formatfalse
--skip-fsSkip filesystem detectionfalse
--check-agent-credentials <LEVEL>skip, check, debugcheck
--path <PATH>Path for filesystem check—
--supported-agents <AGENTS>Filter to specific agentsall

Examples

Basic health check:

ah health

JSON output:

ah health --json

Skip filesystem detection:

ah health --skip-fs

Debug credential issues:

ah health --check-agent-credentials debug

Check specific path:

ah health --path /path/to/repo

Output

The health check displays:

  • Detected terminal multiplexers
  • Available agents and credential status
  • Filesystem snapshot provider support
  • System configuration
configcredentials