Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tryvoss.dev/llms.txt

Use this file to discover all available pages before exploring further.

Voss keeps harness configuration narrow in v0.1. The most important setting is the preferred model.

​
Show or edit config

voss config --show
voss config
The default config path is: 
~/.config/voss/config.toml

​
Switch model in a session

Inside the REPL: 
/model
/model <model-id>
The selected model can be persisted to config.

​
Login flow

Use provider CLIs first, then tell Voss which auth source to prefer when needed: 
claude login
codex login
voss do --auth=claude "summarize this repo"
voss do --auth=api "summarize this repo"
Inside the REPL, /login shows local auth status and refreshes existing credentials when possible.

​
Provider safety

Session persistence must not store provider credentials. Credentials should remain in provider-specific auth storage or environment configuration.
Run voss doctor after changing provider or model settings.