BlueForge Docs

forge login

Authenticate with API key and URL.

Command

forge login --api-key <key> [--api-url <url>]

Arguments

None.

Flags

FlagTypeRequiredDefaultNotes
--api-key
stringyesAPI key
--api-url
stringno
https://mission-control.blueforge.studio
API base URL

Examples

Basic login:

forge login --api-key bf_key_xxxxx

Custom API URL:

forge login --api-key bf_key_xxxxx --api-url https://staging.blueforge.studio

Errors

Exit codeMeaning
0Authenticated successfully
1No API key provided

Pitfalls

  • Key stored locally — the API key is stored in
    ~/.forge/config.json
    for subsequent commands.
  • URL persistence — the API URL is persisted alongside the key. You only need
    --api-url
    on first login or when switching environments.

See also

{auto-injected}

Tested against

{auto-injected}