BlueForge Docs

forge federation list

List registered federation services and their health status.

Command

forge federation list [--no-cache] [--format <format>]

Arguments

None.

Flags

FlagTypeDefaultNotes
--no-cache
bool
false
Bypass 30s health cache
--format
enum
table
table
|
json
|
yaml

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 codeMeaning
0Listed successfully
2Auth failure

Pitfalls

  • Cache hit — results are cached for 30s by default. Use
    --no-cache
    for real-time checks.
  • Degraded services — a
    degraded
    status means the service is reachable but has elevated latency (>100ms).

See also

{auto-injected}

Tested against

{auto-injected}