Repository navigation
rumbo 0.2.0
Configuration is simpler: the system settings, and over them what each
session chooses. The built-in providers sign in with an API key, and
openai speaks OpenAI's Responses API. Some commands and settings have new
names; what you stored is carried over, but for values stored for one
project.
Settings
Settings are now kept apart by what they act on: the system, a session, or
a provider.
rumbo configis nowrumbo system, for the system settings:
default_provideranddefault_model, which new sessions start with,
frontend,max_turns,max_tokens, andcompact_at. Themodel
setting, which held both the provider and the model, is carried over to
the first two once.- Settings are the same everywhere: there are no project settings any more.
Those stored for one project are no longer read, andrumbo system list
shows them. compact_attakes a share of the model's context, such as80%, or0%
for never. One stored as a number of tokens stops rumbo, saying how to
change it.-pchooses the provider and-mthe model alone, which may hold a
slash:rumbo -p local -m qwen3-coder.-m provider/modelno longer
works. What-p,-m, and-ochoose is the session's, kept from one
start to the next, as/useand/session-optionsmake it.- A provider's options are its own, kept with its registration, no longer
theoptions.<provider>setting:rumbo provider options <name> effort=high, or/provider-optionsin the terminal UI. Those already
stored are carried over. - Every field of a provider's or a front end's configuration, and every
option of a provider, now has a value you can see in
rumbo provider showandrumbo provider list: the one you gave, or the
program's own default, which rumbo keeps the first time the program
starts.rumbo provider addstarts the provider, so one that does not
work is not registered. - In the terminal UI,
/helplists the commands by what they act on, and
some have new names:/system,/system-set,/system-unset, and
/system-keyswere/settings,/setting,/unset, and
/setting-keys;/provider-add,/provider-config,/provider-show,
and/provider-rmwere/register,/configure,/inspect, and
/unregister. On the command line,rumbo provider setand
rumbo frontend setare nowrumbo provider configand
rumbo frontend config. - A session keeps the provider options chosen in it, as it keeps its model:
/session-options effort=high. Changing its provider with/useleaves
them behind. The terminal UI's/set, whose choices lasted until it
closed, is gone. - A system setting or a provider's option you store applies to the next
run, without starting rumbo again. The default provider and model, and the
front end, still apply from the next start.
Providers
- The built-in providers sign in with an API key:
/loginasks for it,
checks it, and keeps it in~/.config/rumbo/credentials/, readable only
by you;/logoutremoves it, and/accountsays which credential is in
use. A key in the environment still comes first. - The built-in
openaiprovider offers aneffortoption, sent as
reasoning_effortonly when it is chosen:/session-options effort=high,
-o effort=high, oreffortin its configuration. The values depend on
the model. Likeanthropic, it now refuses options it does not describe. - The built-in
openaiprovider can speak OpenAI's Responses API, which
its reasoning models need to use tools with an effort, and theopenai
rumbo registers on a new installation does. One registered before keeps
Chat Completions untilrumbo provider config openai api=responses. It asks
the server to store nothing, and gives a model its own reasoning back,
encrypted. - In the terminal UI, what a provider's function answers in words shows
without quotes.
Protocols
Both stay at version 1, and what is new in them is optional.
- Each function of the host says what it acts on, in
group:system,
session, orprovider. - A provider's or a front end's answer to
initializemay carryconfig,
its configuration in force, with its default for every field it was not
given. rumbo keeps it with the registration. - Every option a provider describes has a
default, which may be empty
when that means the model decides.rumbo provider addsays which ones a
provider gives none for.