How nimaaskarian/c3 works
Project type and purpose
• This is a single‐binary, Rust-based to-do list application that runs entirely on the user’s machine. It offers both an interactive terminal UI (TUI) mode and a non‐interactive CLI mode, storing data in files using the Calcurse format and extending it into a tree of to-dos with dependencies and notes.
• There is no remote server or database—the “backend” is simply domain logic plus file I/O.
File structure
• Top‐level scripts (release.sh, bump-version.sh, init-aur.sh, clean-aur.sh, etc.) support packaging and CI, not runtime.
• Cargo.toml / src/: a single Rust crate broken into modules:
• cli_app.rs and tui_app.rs (entry points for the two user-facing interfaces)
• lib.rs pulls together sub-modules: date.rs (date calculations), fileio.rs (read/write Calcurse files), todo_app (core domain types: Todo, Note, Schedule, Dependency, TodoList), tui_app sub-modules (potato timer integration, buffer management, tree search).
• benches/ and tests/: performance and correctness suites.
• config.toml: user configuration.
README
• Describes modes (TUI vs CLI), keybinds, usage, and performance tips.