Struct AppConfig 

pub struct AppConfig {
    pub port: u16,
    pub font_size: f32,
    pub theme: ThemeVariant,
    pub orchestrator_root: Option<PathBuf>,
    pub orchestrator: AgentConfig,
    pub worker: AgentConfig,
    pub github_token: Option<String>,
    pub brain: BrainConfig,
    pub theme_file: Option<String>,
    pub harnesses: BTreeMap<String, HarnessSpec>,
}

Fields

port: u16

font_size: f32

theme: ThemeVariant

orchestrator_root: Option<PathBuf>

Override for the orchestrator root directory. Defaults to ~/.config/ninox/orchestrator.

orchestrator: AgentConfig

Agent harness and model for orchestrator sessions.

worker: AgentConfig

Agent harness and model for worker sessions spawned by ninox spawn.

github_token: Option<String>

GitHub personal access token. If absent, falls back to GITHUB_TOKEN env var. Requires repo scope for private repos, public_repo for public.

brain: BrainConfig

Knowledge base (brain) configuration.

theme_file: Option<String>

Theme file name (resolves to ~/.config/ninox/themes/<name>.toml) or an absolute/~-relative path. None uses themes/field-notes.toml if present, else the built-in Field Notes palettes.

harnesses: BTreeMap<String, HarnessSpec>

Agent-harness registry overrides/extensions ([harnesses.<name>]). Builtin specs for claude-code/codex/opencode/aider/freebuff apply when a name is absent here. See crate::harness. Kept last so TOML serialization emits this table-of-tables after every scalar field.

Implementations

impl AppConfig

pub fn registry(&self) -> HarnessRegistry

The effective harness registry: builtin specs overlaid by this config’s [harnesses.*] entries.

pub fn resolved_brain_path(&self) -> PathBuf

Path to the knowledge-base (brain) directory.

Honors the NINOX_BRAIN environment variable as an override: if set, it is treated as an absolute path to the brain directory and returned as-is, mirroring how config_path() honors NINOX_CONFIG. This lets a selected catalogue (see catalogue_options()) be handed to a spawned orchestrator session via its environment without mutating config.toml, and lets tests redirect brain reads/writes without touching the real user brain directory.

Falls back to self.brain.path when set, else <config_dir>/ninox/brain.

pub fn catalogue_options(&self) -> Vec<CatalogueRef>

All selectable knowledge-base catalogues: the implicit “default” (this config’s resolved_brain_path()) followed by any additional catalogues configured under [[brain.catalogues]] — skipping any entry literally named “default” to avoid a confusing duplicate.

pub fn resolved_orchestrator_root(&self) -> PathBuf

pub fn config_path() -> PathBuf

Path to the config.toml file.

Honors the NINOX_CONFIG environment variable as an override: if set, it is treated as an absolute path to the config file itself (not a directory) and returned as-is. This is the same override consumed by spawned agent sessions (see the NINOX_CONFIG env var set alongside NINOX_BIN when launching orchestrator sessions), and it also lets tests redirect config reads/writes away from the real user config file (e.g. ~/Library/Application Support/ninox/config.toml on macOS) without mutating developer machine state.

Falls back to <config_dir>/ninox/config.toml when unset.

pub fn ninox_bin_dir() -> PathBuf

Directory for Ninox-managed shell wrappers prepended to agent PATH. Default: ~/.config/ninox/bin/

pub fn sessions_dir() -> PathBuf

Directory where per-session metadata JSON files are written by wrapper hooks. Default: ~/.config/ninox/sessions/

pub fn load() -> Result<Self>

pub fn save(&self) -> Result<()>

Trait Implementations

impl Clone for AppConfig

fn clone(&self) -> AppConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AppConfig

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

Formats the value using the given formatter.

impl Default for AppConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AppConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AppConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.