Track what apps you use and how long you spend on them.

This app runs in your terminal and shows you exactly where your time goes during work sessions. Built with Ratatui.

• Tracks your app usage - Automatically monitors which programs you're using
• Shows pretty charts - See your time broken down by app and category
• Saves your data - Everything stored locally in your own PostgreSQL database
• Works everywhere - Linux, macOS, and Windows

Copy and paste this into your terminal:

sudo apt update && sudo apt install -y make docker.io curl git openssl && curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && source ~/.cargo/env && git clone https://github.com/adolfousier/neura-hustle-tracker.git && cd neura-hustle-tracker && make run

That's it! The app will start tracking automatically.

1. Install Docker Desktop first
2. Then paste this into Terminal:

brew install make git rustup-init && rustup-init -y && source ~/.cargo/env && git clone https://github.com/adolfousier/neura-hustle-tracker.git && cd neura-hustle-tracker && make daemon-start

3. View your stats anytime: make view

1. Install Docker Desktop
2. Open PowerShell as Administrator
3. Run this:

powershell -Command "iwr -useb https://raw.githubusercontent.com/adolfousier/neura-hustle-tracker/main/src/scripts/windows_build/windows-install.ps1 | iex"

4. View your stats anytime: hustle-view

If you already have the prerequisites installed:

git clone https://github.com/adolfousier/neura-hustle-tracker
cd neura-hustle-tracker
make run

Done! The app handles everything else automatically.

Once the app is running:

• Tab - Switch between Daily, Weekly, and Monthly views
• h - See your complete session history
• r - Rename apps to organize them better
• Shift+C - See all available commands
• q - Quit

The app tracks automatically. Just switch between your programs normally and it records everything.

Run make run and you're done. Everything works in one window.

You need two steps because of how these systems work:

1. Start tracking in background: make daemon-start
2. Open the dashboard: make view

Why? On macOS/Windows, if the tracking runs in the dashboard window, it can't see when you switch to other apps. Running it in the background fixes this.

Commands for daemon mode:

• make daemon-start - Start tracking
• make view - Open dashboard
• make daemon-stop - Stop tracking
• make daemon-status - Check if running

• Computer: Windows 10+, macOS 10.15+, or Linux with a desktop
• Space: About 500MB for Docker and dependencies
• Permissions:
  • macOS needs Screen Recording permission
  • Linux needs a desktop environment (GNOME, KDE, etc.)
  • Windows works out of the box

Wayland users (Linux): Install the Window Calls extension for GNOME to track windows properly.

First time running: The app creates secure database credentials automatically. You don't need to configure anything.

Want the app to start automatically when you log in?

Linux:

mkdir -p ~/.config/autostart/
cp src/scripts/startup/neura-tracker.desktop ~/.config/autostart/

Edit the file and change /path/to/neura-hustle-tracker to your actual path.

macOS:

mkdir -p ~/Library/LaunchAgents/
cp src/scripts/startup/neura-tracker.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/neura-tracker.plist

Windows:

copy src\scripts\startup\neura-tracker.bat "%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\"

• App not starting? Make sure Docker Desktop is running
• Can't see windows? Check permissions in System Settings
• Database errors? Try make clean then make run

Found a bug or want to add something? Check CONTRIBUTING.md.

See LICENSE file for details.

⭐ Star this repository to keep up with exciting updates and new releases, including powerful new features and productivity tracking capabilities! ⭐

Built with ❤️ by the Neura community | Website | Issues