arc

TUI for browsing current iteration stories from Shortcut and managing one-note-per-story markdown files. Notes have YAML frontmatter with story metadata and are Obsidian-compatible.

Setup

1. cargo install --path .
2. Set $EDITOR
3. Get a Shortcut API token
4. Create config at ~/.config/arc/config.toml:

notes_dir = "~/notes/work"
api_token = "your-token-here"
# cache_dir = "~/.cache/arc"  # optional

Usage

arc               # launch TUI
arc open          # open note for active story in $EDITOR
arc tmux          # open/attach tmux session for active story
arc migrate       # one-time: move shortcut-notes config/cache/notes to arc

Keys

Key	Action
j/k	Navigate
Enter	Open note
Space	Expand/collapse description
a	Set active story
t	Tmux session
1-4	Switch tabs
q	Quit

Dev

cargo run                    # run
DUMMY_DATA=1 cargo run       # run without API calls
cargo test                   # test
cargo clippy                 # lint