config.toml

every setting of bise in one file, ~/.bise/config.toml. most of them have a command, so you rarely edit it by hand.

bise reads ~/.bise/config.toml (or $BISE_HOME/config.toml). you rarely need to open it: /models, /voice, shift+tab and bise config set write it for you, and keep the rest of the file as it was. bise models prints the path on its last line, and lists what it can't read as warnings.

#a full example

approvals = "auto"                        # yolo (default) or auto
compaction_threshold = "45%"              # tokens (450000) or a share of the window; at most 80%
project_doc_fallback_filenames = ["CLAUDE.md"]

[roles]
main = "anthropic/claude-opus-5-5"
agents = "openai/gpt-6.1-sol"
small = "mistral/mistral-small-latest"
voice = "mistral/voxtral-transcribe-3"

[roles.main]                              # instead of the main line, to set the effort
model = "anthropic/claude-opus-5-5"
effort = "high"

[voice]
language = "en"
vocabulary = ["bise", "config.toml"]
listen = "auto"

[providers.litellm]
api = "openai-chat"
base_url = "http://localhost:4000/v1"
key_env = "LITELLM_API_KEY"

[models."litellm/claude-sonnet-4-5"]
context = 1000000
vision = true
reasoning = true

#the top-level keys

#[roles]

which model does what. a role is a line (main = "provider/model") or a table with model and effort. see models and roles.

#[voice]

dictation's language and vocabulary, and voice mode's listen, tts_voice, speed, read_aloud and sounds. see voice.

#[providers.<id>] and [models."<id>/<model>"]

add a provider, or change a built-in one key by key: name, api, base_url, key_env, small_model, key_command, headers_env, idle_timeout_sec, and a model's context, max_output, vision, reasoning, tools and prices. see gateways and local models.

#the repo's settings

a few settings belong to one repo, in .switchboard/config.toml at its root:

[flow]
mode = "trunk"            # "pr" or "trunk"; unset: main asks you once
check = "make test"       # what every land runs first
push = true               # trunk: push the default branch after each land

see landing work.

#environment variables