Struct Config 

pub struct Config {

    pub kanban: KanbanSection,
    pub issues_dir: PathBuf,
    pub milestones_dir: Option<PathBuf>,
    pub teams: IndexMap<String, Team>,
    pub cycles: IndexMap<String, PlanningCycle>,
    pub templates: IndexMap<String, IssueTemplate>,
    pub planning: PlanningConfig,
    pub categories: CategoryConfig,
    pub transitions: TransitionConfig,
    pub triage: Option<TriageConfig>,
    pub editor: Option<String>,
    pub viewer: Option<String>,
    pub agent: Option<String>,
    pub state: StateConfig,
    pub export: ExportConfig,
    pub keybindings: KeyBindings,
    pub custom_attributes: CustomAttributes,
    pub lint_foreign_repositories: bool,
    pub layout: LayoutConfig,
    pub types: Option<Vec<String>>,
    pub type_colors: IndexMap<String, String>,
    pub tags_dir: Option<PathBuf>,
    pub repos: IndexMap<String, PathBuf>,
    pub parent_repo: Option<PathBuf>,
}

The project configuration file (tix.toml).

Fields

kanban: KanbanSection

Named board configurations ([kanban]). Always ≥1 after load.

issues_dir: PathBuf

Directory holding issue files, relative to the repo root.

milestones_dir: Option<PathBuf>

Directory holding milestone markdown files, relative to the repo root. None → the default docs/milestones.

teams: IndexMap<String, Team>

Named teams ([teams.<label>]), in declaration order.

cycles: IndexMap<String, PlanningCycle>

Named cycles ([cycles.<name>]), in declaration order.

templates: IndexMap<String, IssueTemplate>

Named new-issue templates ([templates.<name>]), in declaration order.

Optional and absent by default: a project with no templates writes no section, and the F4 New Issue mode simply offers none.

planning: PlanningConfig

Planning presets and the auto-cycle counter ([planning]).

categories: CategoryConfig

[categories]: the global vocabulary and safe default. Omitted when untouched, so a legacy file gains no key on save.

transitions: TransitionConfig

[transitions]: the workflow policy. Omitted when untouched.

triage: Option<TriageConfig>

[triage]: the normal columns that make up the triage inbox.

Mission triage-inbox-review-flow-01M3C600. The inbox is opt-in: None means no section, so no inbox, and every tix triage command refuses by naming the missing section. tix init writes one, with the board columns it needs, so a new repository starts with the inbox on; a legacy tix.toml gains no key on save. See crate::triage::config.

editor: Option<String>

Optional $EDITOR override for full-file editing.

viewer: Option<String>

Read-only viewer for the TUI’s v key (tix #1507).

None and Some("auto") both mean the built-in probe chain — mdterm, then batcat, most, less, more — and every other value names the program to run directly. Never written when unset, so a legacy file gains no key on save.

agent: Option<String>

Configured AI agent command (opencode, claude, etc.) launched with the issue body as its specification. Mirrors the editor resolution chain (explicit → $TIX_AGENT → $AGENT env → PATH fallback).

state: StateConfig

Persisted runtime state ([state]). Tolerated on load for legacy files, never written back to disk (issue #52).

export: ExportConfig

External tracker targets ([export]). Omitted when empty, so a legacy file gains no section on save (#1415).

keybindings: KeyBindings

Sparse TUI keybinding overrides ([keybindings]).

custom_attributes: CustomAttributes

Top-level frontmatter keys this project uses on purpose ([custom_attributes]).

#1361. tix preserves a frontmatter key it does not recognise and warns about it, because an unrecognised key is usually a typo (titel:) and a typo that round-trips silently is worse than one that is dropped. A project that does use a custom key declares it here once and stops being warned.

Top-level names only, not dotted paths — the thing being declared is a top-level key, and accepting a path syntax here would imply nested declarations are checked, which they are not.

lint_foreign_repositories: bool

Whether tix lint also lints the foreign repositories reachable from this store’s related_issues path references and merges their warnings.

Default true. Skipped when true so a tix.toml that does not set it round-trips byte-identically; only an explicit false is written.

layout: LayoutConfig

[layout]: configurable on-disk issue layout.

types: Option<Vec<String>>

Allowed issue type: values (tix #1530 renamed the key from custom_types; the old name is still accepted on read).

tix init writes the default set (see DEFAULT_TYPES); tix lint accepts an issue’s type: only from this list. None falls back to DEFAULT_TYPES, so a repository that never configured it still gets a meaningful check.

type_colors: IndexMap<String, String>

Per-type accent colors ([type_colors], tix #1530).

Maps a type name to a color name. A type with no entry uses the shipped DEFAULT_TYPE_COLORS. Omitted when empty, so an untouched file gains no table on save.

tags_dir: Option<PathBuf>

Directory holding tag definition files (tags_dir, tix #1530).

Each *.md there names a tag and its color:; a tag colors the issue label of the same name in the TUI and the CLI. None → the default docs/tags. Absent by default, so a file gains no key on save.

repos: IndexMap<String, PathBuf>

Child repositories this project coordinates ([repos], tix #1529).

A parent-only map: a project-management repository names the repositories it manages, one level deep, and each value is that child’s project root (the directory holding its tix.toml), relative to this file. Absent by default, so a file gains no section on save. The TUI’s Repos mode lists these and runs tix inside the chosen one.

parent_repo: Option<PathBuf>

The parent repository, when this project is itself a managed child (tix #1529).

Set here, the TUI’s Repos mode offers a limb that runs tix in the parent. The parent also sets TIX_PARENT_REPO when it spawns a child, so the jump back works even without this key.

Implementations

impl Config

pub fn starter() -> Config

The configuration a new repository starts with — what tix init writes.

Deliberately not Default: that is the fallback for a missing or partial tix.toml (and the base hundreds of tests build fixtures on), and it stays minimal. The starting point is a product decision: a new repository gets the board starter_board lays out and a working [triage] section, so tix triage list works on a fresh checkout instead of refusing and asking for configuration first.

The three keys match the board: unreviewed work sits in triage, an accept lands in todo, a decline in wontfix. deferred_status is left unset because it defaults to entry_status, and a default that is never written is a default that cannot drift from the meaning it stands for.

pub fn effective_keybindings(&self) -> Result<EffectiveBindings>

Resolve sparse user overrides over the built-in TUI registry.

pub fn custom_attributes(&self) -> Vec<String>

Declared custom top-level frontmatter keys, lowercased for comparison.

Lowercased because YAML keys are case-sensitive but nobody has ever intended Titel and titel to be different keys, and a suppression list that silently fails to match is worse than no list at all.

pub fn types(&self) -> Vec<String>

The allowed issue types: the configured types, or DEFAULT_TYPES when unset. Compared case-insensitively by callers.

pub fn custom_types(&self) -> Vec<String>

The pre-#1530 name for Self::types, kept so existing call sites and tests read the same list under the old spelling.

pub fn type_color(&self, type_name: &str) -> Option<String>

The color name for issue type, from [type_colors] when set for it, else the shipped DEFAULT_TYPE_COLORS entry. None for a type with no color anywhere (an unknown type). Compared case-insensitively (tix #1530).

pub fn attributes(&self) -> Vec<String>

The attribute list shown and edited in the Config view: the declared [custom_attributes].keys, or the built-in attributes tix models when none are declared. Mirrors Self::custom_types (configured-or-defaults).

pub fn milestones_dir(&self) -> &Path

The resolved milestones directory: the configured value, or the contract default docs/milestones when unset.

pub fn tags_dir(&self) -> &Path

The resolved tags directory: the configured tags_dir, or the contract default docs/tags when unset (tix #1530).

pub fn repos(&self) -> &IndexMap<String, PathBuf>

The child repositories this project coordinates ([repos], tix #1529).

pub fn parent_repo(&self) -> Option<&Path>

The parent repository, when this project is a managed child (tix #1529).

pub fn resolve_repo_paths(&mut self, base: &Path)

Absolutize the paths that are resolved against the project root: an explicitly configured tags_dir, every [repos] entry, and parent_repo (tix #1529/#1530).

Only a relative configured value is rewritten, so an unset key stays None (and is not materialized on save) and an absolute one is left alone. issues_dir/milestones_dir are resolved elsewhere; this covers the newer keys so the TUI can spawn tix in a child from any working directory.

pub fn default_config(&self) -> &BoardConfiguration

The configuration used by the CLI and other single-config surfaces: the one named default if present, else the first declared.

pub fn configs(&self) -> impl Iterator<Item = (&str, &BoardConfiguration)>

Named configurations in declaration order (tab order = declaration order, D-02).

pub fn load_with_warning(path: &Path, sink: impl FnMut(&str)) -> Result<Config>

Load a tix.toml at path, emitting a warning through sink for every cleartext token read from the file.

Parse and validation failures surface as TixError::Config with the file’s path and (where the TOML parser reports it) line.

pub fn load(project_root: &Path) -> Result<Config>

Load the config for a project root: tix.toml at the root if present, otherwise the defaults. An absent file is not an error — the CLI layer decides whether to nag about tix init.

pub fn project_root(cwd: &Path) -> Option<PathBuf>

Find the project root for cwd by walking upward for a tix.toml. Returns None when no ancestor (including cwd itself) holds one.

pub fn save(&self, path: &Path) -> Result<()>

Write tix.toml atomically (temp file + rename in the same directory, with an fsync before the rename — NFR-006).

Tokens are never written to disk, so a round-trip load → save drops any cleartext token (expected: prefer env vars).

Trait Implementations

impl Clone for Config

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

where Config: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Config

impl PartialEq for Config

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Config

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Config