[[categories]]
name = "Configuration and storage"
tips = [
"tix.toml holds settings; boards, cycles and milestones are Markdown files under docs/, so a board can be reviewed in a merge request.",
"A relative issues_dir is resolved against the project root — the directory holding tix.toml — not the directory you ran tix from.",
"The issue layout is configurable: [layout] directory and filename take tokens such as {assignee}, {type}, {status}, {id}, {date} and {slug}.",
"tix layout show prints the resolved layout; tix layout migrate relocates existing files to match it.",
"move_on_change = true relocates an issue when a templated value such as its status changes.",
"An undeclared frontmatter key is preserved on write but tix lint warns about it — declare it once under [custom_attributes] keys = [...] to stop the warning.",
"Tag colors live in one *.md per tag under docs/tags/, and per-type accent colors go under [type_colors] in tix.toml.",
"Every keybinding can be overridden by name in tix.toml; docs/key-bindings.md has the complete table of action names.",
"The [repos] table names child repositories the F6 Repos mode can run tix inside, one level deep.",
"parent_repo (or the TIX_PARENT_REPO environment variable) is how a child session knows the way back to its parent.",
"tix clean removes the backup files tix writes before rewriting an issue; .gitignore already ignores them.",
"tix lint validates every issue's frontmatter and also lints the foreign repositories reachable from related_issues.",
"tix.toml is written atomically — a temp file, an fsync and a rename — so an interrupted write never leaves a half-file.",
"tix edit 3 --files opens the whole issue file in $EDITOR and never clobbers a change another writer made meanwhile.",
]