Struct ForgeToml 

struct ForgeToml {

    orgs: Vec<OrgEntry>,
    accounts: Vec<AccountEntry>,
    models: HashMap<String, ModelSettings>,
    handoff: HandoffSettings,
    dictate: DictateSettings,
    tts: TtsSettings,
    huggingface: HuggingfaceSettings,
    gotify: Option<GotifyConfig>,
    systemone: Option<SystemOneSection>,
    vault: Option<VaultSection>,
    slack: Vec<SlackConfig>,
    plugins: PluginSettings,
    gateway: Option<GatewaySettings>,
    server: ServerConfig,
    client: ClientConfig,
    browser: BrowserSettings,
    terminal: TerminalSettings,
    documents: DocumentsSettings,
    usage: UsageSettings,
    sessions: SessionsSection,
    env: HashMap<String, String>,
}

The whole forge.toml. Unknown keys are rejected so a mistyped section name fails the load instead of being ignored.

Fields

orgs: Vec<OrgEntry>

accounts: Vec<AccountEntry>

models: HashMap<String, ModelSettings>

Optional [models."<name>"] tables - parameters a model name carries to every spawn. Absent means no model parameters are stamped and the CLI’s own resolution stands.

handoff: HandoffSettings

Optional [handoff] section - when forge replaces a session with a fresh one that continues from a brief. Absent means the defaults, which is on at 85% with a compaction backstop of 1.

dictate: DictateSettings

Optional [dictate] section - local dictation. Absent section -> disabled, which is what keeps a 3 GB model download opt-in.

tts: TtsSettings

Optional [tts] section - speech out. Absent section -> disabled, which keeps the model install opt-in.

huggingface: HuggingfaceSettings

Optional [huggingface] section - the token a gated Hub repository needs. Absent section leaves every Hub read untokened.

gotify: Option<GotifyConfig>

Optional [gotify] section - the inbound-notification server connection. Absent section → None → the Gotify subsystem stays dormant.

systemone: Option<SystemOneSection>

Optional [systemone] section - the decision-model endpoint the session tools ask. Absent or enabled = false → None → the tools are never injected.

vault: Option<VaultSection>

Optional [vault] section - the Vaultwarden account the vault family talks to. Absent -> the family is not injected.

slack: Vec<SlackConfig>

Optional [[slack]] sections - one entry per workspace. Absent or empty → the connector stays dormant.

plugins: PluginSettings

Optional [plugins] section - opt-in plugin auto-update. Absent section → all defaults, which leaves auto-update off.

gateway: Option<GatewaySettings>

Optional [gateway] section - the inference listener’s port.

server: ServerConfig

Optional [server] section - the socket’s listener. Absent section means its defaults, which is on and on loopback.

client: ClientConfig

Optional [client] section - the sets a client draws with. Absent section means every name unset, which is the built-in.

browser: BrowserSettings

Optional [browser] section - how the server’s browser hosts encode and when an idle profile closes. Absent section keeps the defaults.

terminal: TerminalSettings

Optional [terminal] section - the shell a seat’s terminal runs, how much scrollback it keeps, and when an idle one closes. Absent section keeps the defaults.

documents: DocumentsSettings

Optional [documents] section - the ceiling on one handed document. Absent section keeps the 10 MiB default.

usage: UsageSettings

Optional [usage] section - the background poller’s refresh interval. Absent section keeps the 60 s default.

sessions: SessionsSection

Optional [sessions] section - whether a dead durable seat comes back. Absent section keeps the defaults, which heal it.

env: HashMap<String, String>

Optional top-level [env] table - the BASE every session starts from, overridden per key by [accounts.env] and then by the project’s env. Merged into LoadedAccount.env at load; the project layer is applied at spawn. Absent -> empty.

Trait Implementations

impl Debug for ForgeToml

Hand-written so the global env’s values stay out of it; the sections it holds redact themselves.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ForgeToml

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.