frame 0.1.5

A markdown task tracker with a terminal UI for humans and a CLI for agents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

# Frame project configuration
# Docs: https://github.com/[owner]/frame

[project]
name = "{{PROJECT_NAME}}"

# Tracks
# ------
# Each [[tracks]] entry defines a workstream. State is one of:
#   active   – shown in tabs and listings
#   shelved  – hidden from default views, preserved for later
#   archived – moved to frame/archive/, read-only
#
# Example:
#
# [[tracks]]
# id = "api"
# name = "API Layer"
# state = "active"
# file = "tracks/api.md"

# ID Prefixes
# -----------
# Maps track IDs to the uppercase prefix used for task IDs.
# e.g. track "api" with prefix "API" generates API-001, API-002, etc.
#
# [ids.prefixes]
# api = "API"

# Agent
# -----
# Settings for AI coding agent integration.
#
[agent]
cc_focus = ""                # track ID for `fr ready --cc` (empty = none)
cc_only = true               # true: agent only works on #cc tasks
                             # false: agent can pick up any unblocked task

# Clean
# -----
# Auto-clean and archival settings.

[clean]
auto_clean = true            # run clean after file reload in TUI
done_threshold = 100         # max done tasks per track before archiving
done_retain = 10             # number of recent done tasks to keep in track after archiving
archive_per_track = true     # separate archive file per track

# UI
# --
# TUI display settings.

[ui]
kitty_keyboard = true        # enhanced keyboard protocol (set false if your terminal has issues)
note_wrap = true             # soft word wrap in note editor
board_done_days = 7          # days of done tasks to show in board view (0 = hide Done column)
default_tags = ["cc"]        # tags always shown in autocomplete
# ref_extensions = ["md"]    # file extensions for ref/spec autocomplete (empty = all)
ref_paths = ["doc", "spec", "docs", "design", "papers"]  # directories for ref/spec autocomplete (empty = whole project)

# Tag Colors
# ----------
# Assign colors to tags. Values are hex colors.
#
# [ui.tag_colors]
# bug = "#FF4444"
# design = "#44DDFF"
# ready = "#44FF88"
# cc = "#CC66FF"
# lost = "#FF8800"

# Color Overrides
# ---------------
# Override default state/UI colors.
#
# [ui.colors]