BackCore Utils

Work-CLI

Utility

Privacy-first terminal time tracker with exports and advanced features.

View on GitHub
Metrics currently unavailable

Installation

git clone https://github.com/mdwcoder/Work-CLI.git && cd Work-CLI && chmod +x init.sh && ./init.sh

Documentation

⚡ Work-CLI

The Ultimate Terminal Time Tracker Privacy-First, Multi-User, AI-Powered, and Cross-Platform.

Work-CLI Banner Python License

🚀 Overview

Work-CLI is a professional time-tracking tool designed for developers who love the terminal. It combines robust time management with advanced features like AI analysis, automated backups, and military-grade encryption.

✨ Key Features

  • ⏱️ Time Tracking: Start/Stop/Pause with descriptions.
  • 📊 Reporting: CSV/PDF exports and Email integration.
  • 🤖 AI Insights: Ask Gemini about your productivity trends.
  • 👤 Multi-User: Secure, isolated accounts with hashed passwords.
  • 🔐 Privacy: AES-256 encryption for your sensitive data.
  • 💾 Auto-Backup: Set it and forget it.

📥 Installation

🐧 Linux / 🍎 MacOS

# Clone & Install
git clone https://github.com/mdwcoder/Work-CLI.git
cd Work-CLI/
chmod +x init.sh
./init.sh

Follow the interactive wizard to set your language, shell, and admin user.

🪟 Windows (PowerShell)

# Run the installer script
.\install.ps1

⚡ Quick Start

1. Start Working

work ON "Refactoring Login System"
# Returns: 🚀 Timer Started at 09:00:00 [Encrypted]

2. Check Status

work TIME
# Returns: ⏱️ Current Session: 01:23:45

3. Finish Work

work OFF
# Returns: 🛑 Stopped. Duration: 04:30:00

🔧 Core Commands

📅 Time Management

CommandAction
work ON [Desc]Start timer (Description optional)
work OFFStop current timer
work TIME-TODAYShow total time today 📅
work TIME-SELECT [Date]Show time for specific date
work TIME-RANGE [D1] [D2]Show total time in range
work INIT-TIMEShow what time you started today 🌅

📊 Reporting & Exports

CommandAction
work EXPORT-CSV [D1] [D2]Export data to CSV
work EXPORT-PDF [D1] [D2]Export data to PDF report
work SEND-TOWait-free: Generate & Email Report 📧
work SEND-BACKUP-TOEmail report from an old Backup 📦

🛡️ Advanced Security & Privacy

👤 User Management

Securely share your machine without sharing your logs.

  • Register: work REGISTER
  • Login: work LOGIN
  • Logout: work USER-LOG-OUT
  • Delete: work USER-DELETE (Permanent!)

🔐 Encryption (AES-256)

Protect your session descriptions.

  • Enable: work ENCRIPT-ON
  • Migration: work CHANGE-KEY (Rotates keys securely)

📜 Audit Logs

All sensitive actions (Logins, Deletions, Backups) are recorded in logs/log.txt.

⚡ Fast Mode

Toggle "Fast Mode" to disable rich UI elements (panels, colors) for a cleaner, plain-text experience.

  • Enable: work FAST-MODE
  • Disable: work NORMAL-MODE

🤖 AI Integration (Gemini)

Unlock insights about your work patterns.

  1. Configure: work AI-CONFIG (Enter API Key)
  2. Ask: 
    work AI-GEN-ASK "How was my productivity last week?"
  3. Contextual: 
    work AI-SEL-ASK-RANGE-TIME 01/01/2024 31/01/2024 "Summarize my main tasks"

💾 Backup & Data

Your data is yours. Local SQLite database.

  • Location: data/working_code.db
  • Manual Backup: work BACKUP
  • Auto-Backup: Configurable (work CONF-BACKUP-AUTO)
    • DAILY, MONTHLY, CUSTOM N
  • Restore: work LOAD-BACKUP

🛠️ Technical Specs

  • Language: Python 3.8+
  • Database: SQLite3
  • Dependencies: typer, rich, cryptography, xhtml2pdf

Built with ❤️ for efficiency.