BlueForge Docs

forge status

Show deployment status of the current project.

Command

forge status [--json]

Arguments

None.

Flags

FlagTypeDefaultNotes
--json
bool
false
Output as JSON

Examples

Human-readable:

forge status
# → Project:  my-app (prj_xxxxx)
# → Status:   ready
# → Plan:     pro
# → Version:  42
# → Last deploy: 2026-07-20 14:30 UTC

JSON output:

forge status --json

Errors

Exit codeMeaning
0Success
2Auth failure (no key, invalid key)

Pitfalls

  • Linked project — shows status for the project linked via
    forge link
    in the current directory.

See also

{auto-injected}

Tested against

{auto-injected}