Skip to content
Documentation
Providers & Presets

Providers & Presets

Choose providers and save presets

Providers and presets define how Valdr connects to AI models and how agents behave at launch time. A provider registers an integration (Claude, Codex, OpenCode, or Ollama). A preset saves the model and session settings you want to reuse. For OpenCode, add an enabled provider with an empty model list, then choose models in your presets.

Together they form an explicit contract: changing a model doesn’t silently change what tools an agent can access, whether it gets a worktree, or what API keys it needs. The configuration is inspectable, exportable, and shareable.

Why this matters

Swapping models without a configuration layer means:

  • Permissions and tool access drift silently
  • Worktree isolation gets inconsistent
  • API keys get hard-coded or forgotten
  • Every team member configures things differently

Providers and presets make the contract explicit. Configure once, export, and every machine runs the same setup.

Use this section to:

  • Understand the JSON format for providers and presets
  • See real examples from a working Valdr installation
  • Learn which fields to customize and which to leave alone
Provider Configuration
JSON format and field reference for providers
Preset Configuration
JSON format and field reference for agent presets
Customization Guide
What to change, what to lock down