A terminal-based personal development tracker combining habit building, productivity, and introspection into one unified system.
Habitrax is a CLI app designed to help you:
- Track your tasks, productivity, and self-discipline
- Reflect daily with randomized deep questions
- Monitor progress using gamified stats and leveling
- Build powerful habits using philosophies from:
- Deep Work
- Atomic Habits
- Slight Edge
- Think & Grow Rich
- Shadow Work Journal
You don't just live life — you level through it.
git clone https://github.com/2kDarki/Habitrax.git
cd Habitrax
python run.pyRequires Python 3.10+ installed.
That's it — Habitrax runs out-of-the-box.
Most productivity apps force structure on you.
Habitrax does the opposite — it's a sandbox for your goals, actions, and reflections.
- Every decision is a vote toward your future self
- Every session is data, analyzed and visualized for self-awareness
- You define your purpose, rules, and trajectory
- Session Logging – Track tasks, time, focus, and productivity quality
- Debrief – Daily introspection with randomized deep questions
- Soul Work – Gratitude, philosophy, and "Slight Edge" voting
- Status Window – Gamified dashboard for categories and missions
- Notebook – Store insights, mantras, or journal entries
- Statistics – Filter and visualize productivity trends
- Missions – Self-defined goals with tracked completion
- Coffer – Manually track your finances
- Almanack – Define your chief aim and personal commandments
- Built entirely on a smartphone as a learning project
- No external dependencies or frameworks
- Made for speed, clarity, and minimalism
- Focus is on function, not flash — every feature serves personal growth
- Language: Python
- Libraries: None (0 dependencies — 100% built-in modules)
- Storage: JSON
- Interface: Terminal-based, menu-driven
Habitrax/
├── src/
└── habitrax/ ← App source code
├── data/ ← Stored user data (JSON)
├── pyproject.toml ← Packaging configuration
├── requirements.txt ← Empty (0 dependencies)
├── run.py ← Entry point
├── README.md ← You are here
├── LICENSE
└── .gitignore
- Status Window
- Soul Work module
- Debrief questions
- Task logging view
- All user data is stored locally in JSON files
- You can back up or migrate manually
- Future versions may support encryption or SQLite (if you can, you may work on this)
- Minimal CLI interface — designed for speed and simplicity
- No undo or in-app editing (by design)
- Manual testing only — no automated tests yet
MIT License — Free to use, modify, or build upon. Mention appreciated if published or monetized.
Self-taught dev passionate about programming and philosophy. Built this to not just track productivity — but to master the self.
Thank you for considering contributing! Here's a simple workflow:
- Fork the repo
- Clone your fork:
git clone https://github.com/YOUR_USERNAME/Habitrax.git
cd Habitrax- Create a branch for your changes: git checkout -b feat/my-feature
- Make your changes (code, data, formatting)
- Stage and commit:
- git add .
- git commit -m "Clear, short description"
- Push your branch: git push origin feat/my-feature
- Open a Pull Request (PR) on GitHub — describe your change clearly
- Optional: add a minimal test in tests/
- Keep naming consistent with existing files
- Minimal formatting: PEP8 recommended, but readability matters most
- Comments welcome for clarity
- There's no automated testing yet
- Please run python run.py to make sure your changes don't break the app
Even if you've never seen the code before, here are 2 tasks anyone can try:
- Improve Debrief Randomization – Add optional filters for categories or difficulty of questions
- Add a CLI Shortcut – For example, a quick command to show today's top task
These tasks are small, self-contained, and won't break the core functionality.