Global Flags

These flags apply to most ah commands.

Logging

Flag	Description	Default
`--log-level <LEVEL>`	Log verbosity: error, warn, info, debug, trace	info
`--log-format <FORMAT>`	Log format: plaintext, json	plaintext
`--log-dir <PATH>`	Directory for log files	Platform-specific
`--log-file <PATH>`	Log filename	—

Flag	Description
`--repo <PATH>`	Target repository path
`--config <PATH>`	Additional configuration file

Flag	Description
`--fs-snapshots <PROVIDER>`	Snapshot provider

Value	Description
`auto`	Auto-detect best provider (default)
`zfs`	ZFS filesystem snapshots
`btrfs`	Btrfs filesystem snapshots
`agentfs`	AgentFS overlay (cross-platform)
`agentfs-fuse`	AgentFS using FUSE
`agentfs-interpose`	AgentFS using DYLD injection (macOS)
`git`	Git shadow commits
`disable`	Disable snapshots

Flag	Description
`--json`	Enable JSON output mode
`--non-interactive`	Single turn, no follow-up prompt

Flag	Description
`--experimental-features <FEATURE>`	Enable experimental features (repeatable)

Debug logging:


ah --log-level debug agent start --agent claude --prompt "Task"

JSON output:


ah --json health

Specific snapshot provider:


ah --fs-snapshots zfs agent start --agent claude --prompt "Task"

Experimental features:


ah --experimental-features gemini agent start --agent gemini --prompt "Task"

Multiple experimental features:


ah --experimental-features gemini --experimental-features copilot health