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

app

assignee

Assignee identities and filesystem-safe directory segments.

board_store

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

bulk

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

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_store

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

edit_problems

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

editor

error

Typed error surface for tix.

git

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

hierarchy

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

ics

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).

model

Issue data model and file-surface types.

planning

The planning registry: teams, cycles and milestones.

records

Reusable frontmatter-record store.

related

Reference grammar and resolution for the related_issues frontmatter field.

relationships

Typed relationship domain service.

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).

triage

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

ui

watcher

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

workflow

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