Terminal calendar. Ratatui TUI, SQLite storage, TOML config.
| Concern | Crate | Why |
|---|---|---|
| TUI | ratatui + crossterm |
Standard combo, pure Rust, no system deps |
| Dates | jiff |
Modern, correct timezone handling, small |
| Config | toml + serde + directories |
XDG paths, TOML config, defaults on first run |
| CLI | clap (derive) |
Subcommands, add without opening the TUI |
| Storage | rusqlite (bundled) |
Real SQL, no external lib, single file |
| Logging | tracing + tracing-subscriber |
RUST_LOG=alpha_app=debug to stderr |
| ICS import/export | icalendar |
Planned: .ics round-trip |
| Errors | anyhow |
Application-level |
Resource footprint: std-only, no async runtime, one background-free event loop at 250ms tick.
| Key | Action |
|---|---|
h / ← |
previous month |
l / → |
next month |
j / ↓ |
previous day |
k / ↑ |
next day |
t |
back to today |
q / Esc |
quit |
alpha-app # open the calendar TUI
alpha-app add "team sync" --date 2026-11-14 --end 15:30
alpha-app add "holiday" --all-day --description "out of office"
alpha-app --config ./dev.toml # custom config pathFirst run writes defaults to ~/.config/alpha-app/config.toml.
See config.example.toml for all options.
Database lives at ~/.local/share/alpha-app/events.db unless overridden.
nix develop # from the development/ repo root: rustc, cargo
cargo run