_________ .__                        __                        __    
 \_   ___ \|  |   ____ _____ ________/  |_____________    ____ |  | __
 /    \  \/|  | _/ __ \\__  \\_  __ \   __\_  __ \__  \ _/ ___\|  |/ /
 \     \___|  |_\  ___/ / __ \|  | \/|  |  |  | \// __ \\  \___|    < 
  \______  /____/\___  >____  /__|   |__|  |__|  (____  /\___  >__|_ \
         \/          \/     \/                        \/     \/     \/ 

cleartrack CLI

Track your terminal clear habits with style.

Features

• Replaces your default clear command seamlessly
• Logs every clear invocation locally for detailed tracking
• Supports useful flags:
  • --stats — display detailed clear stats with charts
  • --reset — reset your clear count and logs
  • --ascii — display fun ASCII art
• Easy installation via pip
• Encourages productive and fun terminal usage tracking

Example

$ clear --stats
[🧼] You've cleared 69 times — just getting started!

🧹 Terminal Clear Stats (Last 10 days)

2025-05-21 | ██████████████████████████████ 3

Average clears per day: 3.0

Installation

pip install cleartrack

Then add the following alias to your shell config .bashrc, .zshrc, or .config/fish/config.fish:

alias clear="cleartrack"

Reload your shell configuration:

source ~/.bashrc  # or source ~/.zshrc, depending on your shell

Usage

Developer Mode

git clone https://github.com/anilrajrimal1/cleartrack.git
cd cleartrack
pip install -e .

📄 License

MIT © Anil Raj Rimal

Clear the noise. Count the habit. — cleartrack