crix-todo

Crates.iocrix-todo
lib.rscrix-todo
version1.0.0
created_at2025-07-07 13:17:52.176623+00
updated_at2025-10-29 00:31:48.836696+00
descriptionA terminal-based todo list manager with CLI and TUI support
homepage
repositoryhttps://github.com/choneface/crix-todo
max_upload_size
id1741258
size98,504
(choneface)

documentation

README

crix-todo πŸ¦€βœ…

Version 1.0.0 – Saracen

A terminal-based task manager written in Rust β€” redesigned from the ground up for speed, simplicity, and focus.
No more cluttered commands. Just one clean, unified experience.


βš™οΈ Overview

crix-todo now runs entirely from a single command:

todo

This launches the interactive TUI, where you can add, edit, delete, split, and reorganize your todos in one streamlined interface.
The philosophy: minimal UI, maximal control.


πŸ“¦ Installation

cargo install crix-todo

πŸš€ Highlights

  • 🧭 Single Command Workflow – Launch everything with just todo.
  • βž• Add Inline – Press = inside the TUI to instantly create a new task.
  • ✏️ Inline Editing – Edit title or notes directly without leaving the view.
  • πŸ” Undo Support – Quickly recover from mistakes with u.
  • πŸͺΆ Simplified Metadata – No tags, no due dates, no β€œdone” status. Just titles, priorities, and notes.
  • 🌳 Modern Tree-Style Layout – Todos and notes are rendered in a clear, visual hierarchy.
  • 🧩 Split Tasks – Break large todos into smaller parts with a single keypress.
  • ⚑ Instant State Persistence – All changes are saved immediately to your local JSON store.

🎨 Example Layout

Priority 0
╭─ Workout session
β”‚   ╰─ Notes: Leg day today at the gym
╰─ Schedule dentist appointment

Priority 1
╭─ Buy groceries
β”‚   ╰─ Notes: Don’t forget coffee
╰─ Finish Rust project
╰─ Notes: Add tree-style notes rendering

⌨️ TUI Keybindings

Normal Mode

╭─ [j/k] Move selection up or down  
β”œβ”€ [Space] Expand or collapse todo  
β”œβ”€ [i] Edit (title if collapsed, notes if expanded)  
β”œβ”€ [=] Add a new todo  
β”œβ”€ [⌫] Delete selected todo  
β”œβ”€ [p/l] Toggle priority up/down  
β”œβ”€ [b] Split a todo into part 1 and part 2  
β”œβ”€ [u] Undo last action  
β”œβ”€ [h] Show keybindings help menu  
╰─ [Esc] Quit the TUI

Edit Mode

╭─ [Char/Space] Input character  
β”œβ”€ [←/β†’] Move cursor  
β”œβ”€ [⌫] Backspace  
╰─ [Esc] Return to Normal Mode

πŸ“‚ Data Storage

Todos are stored locally in a plain JSON file named todo.json.
No sync, no cloud β€” your data stays on your machine.


πŸ§ͺ Development

Clone the repository and run the TUI directly:

cargo run

🏈 About the Release

Saracen (v1.0.0) is a complete rebuild of crix-todo.
Inspired by the clear-headed leadership of Matt Saracen from Friday Night Lights, this release is about clarity, confidence, and control.

Clear eyes. Full hearts. No distractions.

Commit count: 0

cargo fmt