Settings
Settings
~/.fabro/settings.toml
Vendor docs
config
| name | type | required | meaning | concept | |
|---|---|---|---|---|---|
| cli.exec.agent.mcps | string |
Agent-scoped MCP entries for `fabro exec`.
|
docs ↗ | ||
| cli.exec.agent.permissions | string |
Tool permission level for `fabro exec`.
|
docs ↗ | ||
| cli.exec.model.name | string |
Model name for `fabro exec`.
|
docs ↗ | ||
| cli.exec.model.provider | string |
LLM provider for `fabro exec`.
|
docs ↗ | ||
| cli.exec.prevent_idle_sleep | string |
Prevent idle sleep on macOS while an exec run is in flight.
|
docs ↗ | ||
| cli.logging.level | string |
Default CLI log level.
|
docs ↗ | ||
| cli.output.format | string |
Output format for commands that support machine-readable output.
|
docs ↗ | ||
| cli.output.verbosity | string |
Default output verbosity.
|
docs ↗ | ||
| cli.target.path | string |
Required for `type = "unix"`; the absolute Unix socket path.
|
docs ↗ | ||
| cli.target.type | string |
Explicit transport selection.
|
docs ↗ | ||
| cli.target.url | string |
Required for `type = "http"`; the API base URL.
|
docs ↗ | ||
| cli.updates.check | string |
Check for new Fabro releases during supported CLI commands.
|
docs ↗ | ||
| llm.models.<id>.agent_profile | string |
Agent profile override for this model. Model overrides take precedence over provider overrides.
|
docs ↗ | ||
| llm.models.<id>.aliases | string |
Additional model names accepted by routing and fallback config.
|
docs ↗ | ||
| llm.models.<id>.api_id | string |
Identifier sent to the provider API.
|
docs ↗ | ||
| llm.models.<id>.billing_policy | string |
Billing algorithm override for this model — for models whose billing family differs from their provider's (e.g. Claude served through OpenRouter bills Anthropic-style cache reads/writes).
|
docs ↗ | ||
| llm.models.<id>.controls.reasoning_effort | string |
User-facing reasoning effort values Fabro may send for this model. Can be set explicitly for reasoning models whose provider adapter maps effort to a non-native API shape.
|
docs ↗ | ||
| llm.models.<id>.controls.speed | string |
Additional speeds beyond implicit `standard`; do not list `standard`.
|
docs ↗ | ||
| llm.models.<id>.costs.cache_input_cost_per_mtok | string |
Cached input/read cost in USD per million tokens.
|
docs ↗ | ||
| llm.models.<id>.costs.input_cost_per_mtok | string |
Input cost in USD per million tokens.
|
docs ↗ | ||
| llm.models.<id>.costs.output_cost_per_mtok | string |
Output cost in USD per million tokens.
|
docs ↗ | ||
| llm.models.<id>.default | string |
Whether this is the provider default model.
|
docs ↗ | ||
| llm.models.<id>.display_name | string |
Human-readable model name.
|
docs ↗ | ||
| llm.models.<id>.enabled | string |
Set `false` to disable a model after lower-precedence layers define it.
|
docs ↗ | ||
| llm.models.<id>.estimated_output_tps | string |
Estimated output tokens per second for catalog display and planning.
|
docs ↗ | ||
| llm.models.<id>.family | string |
Family label used for catalog display and matching.
|
docs ↗ | ||
| llm.models.<id>.features.prompt_cache | string |
Whether prompt cache pricing/usage applies.
|
docs ↗ | ||
| llm.models.<id>.features.reasoning | string |
Whether the model has reasoning behavior.
|
docs ↗ | ||
| llm.models.<id>.features.reasoning_effort | string |
Whether the model endpoint supports a native reasoning-effort parameter. `levels` accepts discrete effort levels; `always_adaptive` accepts effort levels with natively always-on adaptive thinking; `none` has no native effort parameter.
|
docs ↗ | ||
| llm.models.<id>.features.sampling_params | string |
Whether the model accepts classic sampling parameters (`temperature`, `top_p`).
|
docs ↗ | ||
| llm.models.<id>.features.tools | string |
Whether the model supports tool calls.
|
docs ↗ | ||
| llm.models.<id>.features.vision | string |
Whether the model accepts image inputs.
|
docs ↗ | ||
| llm.models.<id>.knowledge_cutoff | string |
Public knowledge cutoff label; TOML dates normalize to `YYYY-MM-DD`.
|
docs ↗ | ||
| llm.models.<id>.limits.context_window | string |
Maximum context window size in tokens.
|
docs ↗ | ||
| llm.models.<id>.limits.max_output | string |
Maximum output tokens, if known.
|
docs ↗ | ||
| llm.models.<id>.probe | string |
Whether this model should be preferred for provider connectivity probes. Set `false` in a higher-precedence layer to clear an inherited probe marker.
|
docs ↗ | ||
| llm.models.<id>.provider | string |
Provider ID this model belongs to.
|
docs ↗ | ||
| llm.models.<id>.training | string |
Training data cutoff label.
|
docs ↗ | ||
| llm.providers.<id>.adapter | string |
Adapter registry key, such as `"anthropic"`, `"openai"`, `"gemini"`, or `"openai_compatible"`. Required for new providers.
|
docs ↗ | ||
| llm.providers.<id>.agent_profile | string |
Agent profile used for project memory, CLI/ACP command selection, and native session routing. Override only when a provider needs profile behavior different from its adapter.
|
docs ↗ | ||
| llm.providers.<id>.aliases | string |
Additional provider names accepted by model routing and fallback config.
|
docs ↗ | ||
| llm.providers.<id>.auth | string |
API-key auth config. Omit the table entirely for providers that need no API key; any `extra_headers` are still attached.
|
docs ↗ | ||
| llm.providers.<id>.auth.credentials | string |
Ordered credential refs. Accepted forms are `vault:<NAME>`, `env:<NAME>`, and `aws_sigv4` (sign requests from the AWS default credential chain — Bedrock). Literal secret strings are rejected.
|
docs ↗ | ||
| llm.providers.<id>.auth.header | string |
Primary API-key header policy. Omit when the provider uses a standard bearer token.
|
docs ↗ | ||
| llm.providers.<id>.base_url | string |
Provider API base URL. Required for most custom OpenAI-compatible providers.
|
docs ↗ | ||
| llm.providers.<id>.billing_policy | string |
Provider-owned billing algorithm for usage estimates. Override for exceptional providers such as local no-billing runtimes.
|
docs ↗ | ||
| llm.providers.<id>.display_name | string |
Human-readable provider name.
|
docs ↗ | ||
| llm.providers.<id>.enabled | string |
Set `false` to disable a provider after lower-precedence layers define it.
|
docs ↗ | ||
| llm.providers.<id>.extra_headers | string |
Additional headers attached to provider requests. Values are interpolation strings: literal text, an `{{ env.NAME }}` token, or a `{{ secrets.NAME }}` token. Put credentials in a secret and reference them with a `{{ secrets.NAME }}` token, not a bare literal.
|
docs ↗ | ||
| llm.providers.<id>.priority | string |
Higher-priority configured providers win default selection; ties use canonical provider ID.
|
docs ↗ | ||
| run.agent.fabro_tools | string |
Allow workflow agents to use Fabro run-management tools.
|
docs ↗ | ||
| run.agent.mcps | string |
Agent-scoped MCP server entries, keyed by name.
|
docs ↗ | ||
| run.agent.mcps.<name>.command | string |
Command and arguments for `stdio` or `sandbox` transports.
|
docs ↗ | ||
| run.agent.mcps.<name>.env | string |
Additional environment variables for process-launching transports.
|
docs ↗ | ||
| run.agent.mcps.<name>.headers | string |
HTTP headers for `http` transport.
|
docs ↗ | ||
| run.agent.mcps.<name>.port | string |
Sandbox port for `sandbox` transport.
|
docs ↗ | ||
| run.agent.mcps.<name>.script | string |
Shell script alternative to `command` for process-launching transports.
|
docs ↗ | ||
| run.agent.mcps.<name>.startup_timeout | string |
Max duration for startup and MCP handshake.
|
docs ↗ | ||
| run.agent.mcps.<name>.tool_timeout | string |
Max duration for a single MCP tool call.
|
docs ↗ | ||
| run.agent.mcps.<name>.type | string |
MCP transport type.
|
docs ↗ | ||
| run.agent.mcps.<name>.url | string |
Remote MCP URL for `http` transport.
|
docs ↗ | ||
| run.agent.permissions | string |
Default tool permission level for workflow agents.
|
docs ↗ | ||
| run.git.author.email | string |
Git author email for checkpoint commits.
|
docs ↗ | ||
| run.git.author.name | string |
Git author name for checkpoint commits.
|
docs ↗ | ||
| run.model.fallbacks | string |
Ordered list of fallback model references. Supports `...` splice marker at layering time — see [`super::splice_array`].
|
docs ↗ | ||
| run.model.name | string |
Model name for workflow runs.
|
docs ↗ | ||
| run.model.provider | string |
Provider name for workflow model selection.
|
docs ↗ | ||
| run.pull_request.auto_merge | string |
Enable GitHub auto-merge for created pull requests. Implies `draft = false`.
|
docs ↗ | ||
| run.pull_request.draft | string |
Open created pull requests as drafts.
|
docs ↗ | ||
| run.pull_request.enabled | string |
Automatically create a PR after successful runs.
|
docs ↗ | ||
| run.pull_request.merge_strategy | string |
Merge method to configure for the pull request.
|
docs ↗ |