Crate tix 

tix — a terminal issue tracker.

Issues live as human- and agent-readable markdown files with YAML frontmatter in a version-controlled directory (docs/issues/ by default), and are manipulated both by a full clap CLI and a ratatui kanban board. tix export/tix import shell out to glab/linear-cli for external sync (contracts/external-tools.md).

WP01 shipped the immutable foundation: the error type, the slug filename stem builder, the model (issue, status, priority, config entities) and the config reader/writer. WP02 added the storage façade over issues_dir and the editor bridge. WP03 adds the full clap cli command tree, the per-command commands handlers, and the minimal TUI app shell. WP05 fills in the external sync module (token resolution, glab/linear-cli adapters, export/import orchestration). Consumers freeze on the public API shipped here.

Modules

analytics

Burndown and scope analytics (mission burndown-scope-analytics-01M3C9J1).

app

assignee

Assignee identities and filesystem-safe directory segments.

backup

Centralized, prunable backups of issue files (#1581).

board_store

The board configuration store: docs/boards/<name>.md.

bulk

Bulk issue editing — the selection and typed patch layer (WP01).

capacity

Cycle capacity planning (mission cycle-capacity-planning-01M3C85C).

cli

The clap command tree, the frozen exit-code scheme, and the process boundary that resolves config, opens the store and hands off to the per-command handlers.

commands

Thin dispatch: route a parsed CLI Command to its per-command handler module. Also owns the shared <issue> selector resolution and priority validation that several commands reuse.

config

tix.toml config schema, defaults, loading, saving and validation.

cycle_schedule

Repeating cycle schedules (mission repeating-cycle-schedules-01M3C7W1).

cycle_store

The cycle store: docs/cycles/<name>.md.

diagnostics

The crate’s one diagnostic renderer (#1576).

edit_problems

Every problem an editor round trip can leave behind, and the repair tix can apply to each one (tix #1506).

editor

epics

The single owner of epic behaviour (mission epics-work-items-01M3BYW4, WP02 — contracts/epic-service.md).

error

Typed error surface for tix.

git

Best-effort git plumbing for recording the commit that closes an issue.

health

Project and issue health: a state, a rationale, and a versioned policy for deriving one from the things that contribute to it (mission project-issue-health-status-01M3C8HX).

hierarchy

The single owner of hierarchy behaviour (mission parent-issues-subissues-01M3BXX3, WP01).

ics

id

Short, collision-resistant issue identifiers.

keybindings

kitty

Spec Kitty integration — kitty-specs/ artifact support for tix.

layout

Configurable on-disk issue layout ([layout] in tix.toml).

mcp

MCP server entry point and dispatch loop (tix mcp).

mentions

Durable @handle and @email mentions.

model

Issue data model and file-surface types.

planning

The planning registry: teams, cycles and milestones.

projects

The single owner of project behaviour (mission first-class-projects-01M3BYBW, WP02).

records

Reusable frontmatter-record store.

recurrence

The recurrence boundary: supported series rules and the schedule arithmetic behind them (mission recurring-issues-01M3C7G7, WP01).

related

Reference grammar and resolution for the related_issues frontmatter field.

relationships

Typed relationship domain service.

roadmap

Roadmap initiatives: stable strategic outcomes connected to execution.

search

Shared search corpus and matchers for tix search (CLI, WP04) and the / search (TUI, WP05).

slug

Title → kebab-case filename stem.

speckit

tix import --target speckit: mirror a local GitHub Spec Kit project onto the tix board.

storage

sync

External tracker sync: orchestration for tix export / tix import, the Tool selector, the CommandRunner spawn seam, and the pure mapping / conflict-resolution rules.

tags

Tag definitions (tix #1530).

templates

Stable, data-only issue and form templates.

time_tracking

Per-issue time tracking (mission per-issue-time-tracking-01M3C9A4).

tips

The startup tips the TUI shows (tix #1632).

triage

Triage inbox: configuration, entry metadata, and the inbox query.

ui

views

Saved issue views (mission saved-issue-views-01M3C926).

watcher

Dependency-free polling filesystem watcher (issue #10).

wip

Work-in-progress limits: the configuration, the estimate arithmetic, and — in the work packages that follow — one shared move policy over them (mission configurable-wip-limits-01M3C6WX).

workflow

The single owner of category resolution, completion, and transition legality.