​
Config file

Location (XDG-compliant):
  • macOS / Linux: ~/.config/orgs/config.toml
  • Windows: %APPDATA%\orgs\config.toml

​
Structure

# Default profile
[default]
api_url = "https://api.orgs.sh/v1"
api_key = "sk_live_..."
default_entity = "helios-research"
editor = "vim"
output_format = "table"    # table | json | yaml | toml

# Additional profiles
[profiles.staging]
api_url = "https://api.stage.orgs.sh/v1"
api_key = "sk_test_..."

[profiles.local]
api_url = "http://localhost:3001/v1"
api_key = "sk_test_local"

# Key store (for hardware keys)
[keys.yubikey]
slot = "signing"

[keys.ledger]
derivation_path = "m/44'/501'/0'/0'"

​
Environment variables

Environment variables override config file:
  • ORGS_API_URL
  • ORGS_API_KEY
  • ORGS_PROFILE
  • ORGS_DEFAULT_ENTITY
  • ORGS_OUTPUT_FORMAT
  • ORGS_EDITOR
  • ORGS_NO_COLOR=1

​
Profiles

Switch profiles: 
orgs --profile staging entity list
# or
ORGS_PROFILE=staging orgs entity list

​
Output formats

  • table (default) — human-readable
  • json — machine-readable, single-line
  • yaml — machine-readable, multi-line
  • toml — machine-readable, similar to config
orgs entity list --format json | jq '.[0].id'

​
Scripting

For CI or scripts, prefer: 
orgs entity list --format json --no-interactive
--no-interactive disables confirmation prompts and TTY features. All commands exit with meaningful codes:
  • 0 — success
  • 1 — general failure
  • 2 — validation error
  • 3 — auth error
  • 4 — rate-limited

​
Verbosity

orgs -v entity get helios-research       # INFO logs
orgs -vv entity get helios-research      # DEBUG logs
orgs -vvv entity get helios-research     # TRACE logs

​
Telemetry

Opt-in anonymous telemetry: 
orgs telemetry enable    # Opt in
orgs telemetry disable   # Opt out (default)
orgs telemetry status
No PII ever sent. See our privacy policy for details.