Skip to content

hackclub-community/hackatime-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

0b5bbeb · · Mar 18, 2026

History

6 Commits
Mar 18, 2026
Mar 18, 2026
Mar 13, 2026
Mar 12, 2026
Mar 18, 2026
Mar 13, 2026
Mar 18, 2026
Mar 18, 2026
Mar 12, 2026
Mar 18, 2026
Mar 18, 2026

Repository files navigation

Hackatime Terminal Viewer

A Rust terminal app that signs into Hackatime with OAuth PKCE and prints a simple stats summary.

Install

  • From crates.io: cargo install hackatime
  • Then run: hackatime
  • Enjoy :)

Commands

  • hackatime shows the multi-range summary plus lifetime languages
  • hackatime . shows stats for the current folder if it matches one of your Hackatime projects
  • hackatime settings shows the current saved settings
  • hackatime settings color opens an arrow-key color picker with the fetch h preview
  • hackatime settings clear toggle toggles terminal clearing on or off
  • hackatime settings clear on|off explicitly enables or disables terminal clearing
  • HACKATIME_CONFIG_DIR=/some/folder hackatime settings color stores settings in a custom config directory
  • hackatime --lookup me> shows another person's public Hackatime stats
  • hackatime --lookup -ggt; -g shows another person's graph
  • hackatime --lookup --projects --year--year shows another person's top projects for that range
  • hackatime --fetch (-f) shows a neofetch-style overview
  • hackatime --graph (-g) shows a GitHub-style coding heatmap for the last 365 days
  • hackatime --projects (-p) shows your top projects with per-project language graphs and a key
  • hackatime --projects --week|--month|--year scopes that projects view to a time range
  • hackatime --current (-c) shows the current project report
  • hackatime --today (-d) shows today's total plus today's languages
  • hackatime --week (-w) shows this week's total plus this week's languages
  • hackatime --month (-m) shows this month's total plus this month's languages
  • hackatime --year (-y) shows this year's total plus this year's languages
  • hackatime --lifetime (-l) shows lifetime total plus lifetime languages
  • hackatime logout clears your saved Hackatime login

Current features

  • Browser-based OAuth login using PKCE
  • Reuses your saved access token on later runs so you do not log in each time
  • Saves your preferred fetch theme and terminal-clearing behavior
  • Lets you change saved settings directly from the command line
  • Supports a custom config directory with HACKATIME_CONFIG_DIR
  • Can show the current folder as a project with hackatime .
  • Lets you clear the saved token with hackatime logout
  • Fetches your profile
  • Prints a plain text stats summary and exits

Planned features

About

View hackatime stats in your terminal

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published