Config Commands

Manage CLI configuration settings.

Global options available on all config commands: --json, --no-color.

Configuration File

Configuration is stored in a JSON file at:

Linux/macOS: ~/.config/bb/config.json
Windows: %APPDATA%\bb\config.json

Available Settings

The configuration file stores your CLI settings and authentication credentials.

Key	Description
`username`	Bitbucket username (set during `auth login`)
`apiToken`	Bitbucket API token (set during `auth login`, masked in output)
`defaultWorkspace`	Default workspace for commands
`skipVersionCheck`	Disable update notifications (default: false)
`versionCheckInterval`	Days between update checks (default: 1)

Configuration File Format

The config file is stored as JSON:

{
  "username": "myuser",
  "apiToken": "***",
  "defaultWorkspace": "myworkspace",
  "skipVersionCheck": false,
  "versionCheckInterval": 1
}

`bb config get`

Get a configuration value.

bb config get <key>

Arguments

Argument	Description
`key`	Configuration key to retrieve

Examples

# Get default workspace
bb config get defaultWorkspace

# Get username
bb config get username

# Get output as JSON
bb config get defaultWorkspace --json

Options

Option	Description
`--json`	Output as JSON

`bb config set`

Set a configuration value.

bb config set <key> <value>

Arguments

Argument	Description
`key`	Configuration key to set
`value`	Value to set (parsed by key type)

Typed Value Parsing

bb config set validates and stores typed values for known typed keys:

Key	Accepted values	Stored type
`defaultWorkspace`	Any string	string
`skipVersionCheck`	`true` or `false`	boolean
`versionCheckInterval`	Positive integer (`>= 1`)	number

Examples

# Set default workspace
bb config set defaultWorkspace myworkspace

# Disable update notifications
bb config set skipVersionCheck true

# Check for updates weekly instead of daily
bb config set versionCheckInterval 7

# Invalid values are rejected
bb config set skipVersionCheck maybe

# Get output as JSON
bb config set defaultWorkspace myworkspace --json

Example JSON output for typed keys:

{ "success": true, "key": "skipVersionCheck", "value": true }

Options

Option	Description
`--json`	Output as JSON

`bb config list`

List all configuration values.

bb config list [options]

Options

Option	Description
`--json`	Output as JSON

Examples

# List all config
bb config list

# List as JSON for scripting
bb config list --json

Output

Config file: /Users/you/.config/bb/config.json

KEY               VALUE
-----------------  ---------
username          myuser
defaultWorkspace  myworkspace
apiToken          ********