Skip to main content
Everything the dashboard shows you, from the terminal. The CLI signs in as your real Belvedir account, so it sees exactly the organizations, projects, and keys the dashboard would.
belvedir login opens the Belvedir dashboard, where you’re usually already signed in — click Approve and the terminal is in. Email/password accounts can skip the browser entirely: belvedir login --email you@example.com. The session lives in ~/.config/belvedir/credentials.json, refreshes automatically, and belvedir logout forgets it.

Reading your data

Projects are referenced by UUID or by name when it’s unambiguous. Every read takes --json for raw output ready to pipe into jq.

Acting

Paid actions (training runs) charge the project’s organization balance exactly like the dashboard, with the same refund rules.

Notes

  • Requires Node 18 or newer. The package has no dependencies.
  • Sending traces is not the CLI’s job — that’s the @belvedir/loop SDK.
  • Self-hosted or staging platform: belvedir login --platform https://your-host.