Config Commands

Manage CLI configuration settings.

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)
`workspace`	Default workspace for commands
`repo`	Default repository for commands

Configuration File Format

The config file is stored as JSON:

{
  "username": "myuser",
  "apiToken": "***",
  "workspace": "myworkspace",
  "repo": "myrepo"
}

`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 workspace

# Get username
bb config get username

`bb config set`

Set a configuration value.

bb config set <key> <value>

Arguments

Argument	Description
`key`	Configuration key to set
`value`	Value to set

Examples

# Set default workspace
bb config set workspace myworkspace

# Set default repository
bb config set repo myrepo

`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
workspace         myworkspace
appPassword       ********