forge federation list
List registered federation services and their health status.
Command
forge federation list [--no-cache] [--format <format>]
Arguments
None.
Flags
| Flag | Type | Default | Notes |
|---|---|---|---|
| bool | | Bypass 30s health cache |
| enum | | | | |
Examples
Default table view:
forge federation list
# → SERVICE STATUS LATENCY
# → service-auth healthy 12ms
# → service-err healthy 8ms
# → service-git degraded 120ms
JSON output:
forge federation list --format json
Errors
| Exit code | Meaning |
|---|---|
| 0 | Listed successfully |
| 2 | Auth failure |
Pitfalls
- Cache hit — results are cached for 30s by default. Use
for real-time checks.--no-cache - Degraded services — a
status means the service is reachable but has elevated latency (>100ms).degraded
See also
{auto-injected}
Tested against
{auto-injected}