Configuration

Tate stores its configuration in .tate/config (TOML format). All fields have defaults. A missing field uses its default. An empty config file is valid.

Default configuration

Generated by tate init:

[scheduling]
max_interval = 365              # max days between reviews
new_card_limit = 20             # max new cards introduced per day

[display]
show_code = true                # show source code during review
color = true                    # terminal colors

[hooks]
auto_add = true                 # enable post-commit auto-population
track_patterns = [              # commit message patterns that trigger auto-add
    "Co-authored-by:.*Claude",
    "Co-authored-by:.*Copilot",
    "Co-authored-by:.*Cursor",
    "Generated by",
    "🤖",
]

Scheduling

max_interval

Maximum number of days between reviews for any card. Default: 365.

The SM-2 algorithm can produce very long intervals for cards you consistently grade Easy. This caps them so nothing disappears for more than a year.

new_card_limit

Maximum number of new cards (never-reviewed) introduced in a single review session. Default: 20.

This prevents a large deck from overwhelming a single session. Cards already in rotation (learning or mature) are always shown when due, regardless of this limit.

Display

show_code

Whether to display the source code during review. Default: true.

When true, the review TUI shows the full source of the card's entry (file contents, symbol body, or line range) with syntax highlighting and line numbers.

color

Whether to use terminal colors. Default: true.

Set to false for environments without color support.

Hooks

auto_add

Whether the git post-commit hook auto-populates the deck. Default: true.

When enabled, commits matching track_patterns trigger automatic symbol extraction and deck population.

track_patterns

List of regex patterns matched against commit messages. Default matches common AI-assisted commit markers.

When a commit message matches any pattern, all symbols from changed files are added to the deck.

Set to [".*"] to track all commits. Remove patterns to narrow the scope.

# Track everything
track_patterns = [".*"]

# Only track Claude-assisted commits
track_patterns = ["Co-authored-by:.*Claude"]

# Disable pattern matching (manual adds only)
track_patterns = []