HackaTime Doctor

A diagnostic tool that verifies your development environment meets all requirements for Hack Club's HackaTime and helps in its setup and fixing.

HackaTime Doctor Demo

Features

Core Checks

Git installation, API connectivity test, and WakaTime config validation to ensure your environment is ready.

Installation & Setup

Auto-install for missing packages with multi-package manager support across all platforms.

Reporting & Output

JSON and CSV report generation with color-coded terminal output and detailed error messages.

Diagnostic Checks

Git Installation Check

Verifies Git is installed and accessible in your PATH

API Connectivity Test

Tests connection to HackaTime server for proper API communication

WakaTime Config Validation

Validates WakaTime configuration files across multiple locations

Project Structure Validation

Checks for required project files like README.md, LICENSE, and .gitignore

Other Tools

Can verify installation of other devtools(Right now just added in NodeJS will add more in the future)

Install HackaTime Doctor

Download the latest release for your platform:

                # Download from GitHub Releases
https://github.com/arungeorgesaji/hackatime-doctor/releases/latest
            

Usage

After installation, run the diagnostic tool:

                # Basic diagnostics
hackatime-doctor

# Extended diagnostics
hackatime-doctor --full-check

# Generate JSON report
hackatime-doctor --json

# Generate CSV report
hackatime-doctor --csv
            

Note: HackaTime Doctor though cross-platform has the best compatibility for linux.