frontmatter PAR AVION

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 ↗