Configuration

buzz stores its configuration in ~/.buzzrc, a JSON file created during authentication. Most users never need to edit it by hand, but a few optional settings live here.

Additional accounts (optional)

buzz auth login manages these for you (see multiple accounts), but they are plain JSON if you’d rather edit them directly. The top-level username/auth_token is the primary account; accounts holds any others:

{
  "username": "alice",
  "auth_token": "alice_token",
  "accounts": [
    {"username": "bob", "auth_token": "bob_token"}
  ]
}

log_file and base_url are not per-account — they apply to every account.

Logging (optional)

buzz can log HTTP requests and responses to help with debugging and monitoring API calls. Logging is disabled by default to respect your preferences and avoid cluttering your filesystem.

To enable it, add a log_file field to ~/.buzzrc:

{
  "username": "your_username",
  "auth_token": "your_token",
  "log_file": "/path/to/buzz.log"
}

When logging is enabled, buzz appends timestamped entries for each HTTP request and response to the specified file:

[2025-12-09 12:34:56] REQUEST: GET https://www.beeminder.com/api/v1/users/alice/goals.json?auth_token=***
[2025-12-09 12:34:57] RESPONSE: 200 https://www.beeminder.com/api/v1/users/alice/goals.json?auth_token=***

To disable logging, remove the log_file field from ~/.buzzrc or set it to an empty string.

Note

buzz redacts your auth_token to auth_token=*** before writing URLs to the log file, so your token isn’t recorded on disk.