A terminal-based habit tracker designed for neurodivergent users. Focuses on progress patterns rather than perfect streaks.

• Pattern-based tracking: Weekly progress patterns instead of breakable streaks
• Neurodivergent-friendly: Built with ADHD considerations in mind
• Dual habit types: Track habits to build and habits to avoid
• Minimal interface: Keyboard-driven with essential information only
• Local storage: All data stored locally using TOML files

Traditional habit trackers often fail neurodivergent users by:

• Resetting progress after missing a single day
• Overwhelming with excessive options and tracking
• Focusing on perfection rather than sustainable progress
• Requiring daily consistency that doesn't account for executive dysfunction

Flow State addresses these issues by emphasizing patterns over perfection and providing encouragement rather than judgment.

Instead of streaks, Flow State tracks weekly patterns.

• Mastered (5): Strong, consistent pattern
• Established (4): Good momentum established
• Developing (3): Pattern forming
• Struggling (2): Frequent relapse
• Chaotic (1): Inconsistent

cargo install flow_state

Or build from source:

git clone https://github.com/Stan-breaks/flow_state
cd flow-state
cargo build --release

flow_state

• flow-state - Start the application
• q - Quit
• TAB - Switch between views (Today/Manage/Stats)
• y - Switch between editing Today and Yesterday, in case you forgot to mark things off
• ENTER - Toggle habits in Today view
• hjkl - Navigate (Vim-motions)

Today View: Daily habit check-in and progress overview Stats View: Pattern health check and habit maturity

• Language: Rust
• TUI Library: ratatui
• Storage Format: TOML
• Platform Support: Linux, macOS, Windows
• Dependencies: Minimal, focused on core functionality

• Rust 1.70+
• Cargo

cargo build
cargo run

Contributions welcome, especially from neurodivergent developers who understand the target use case. Please focus on:

• Accessibility improvements
• ADHD-friendly UX enhancements
• Performance optimizations
• Cross-platform compatibility

Built with input from the neurodivergent community to create tools that work with different brain types rather than against them.