Find a file
2025-12-15 15:06:05 +01:00
.github Add pull_request_template.md 2025-12-15 15:06:05 +01:00
history Refactored command/args parsing 2023-09-06 22:12:47 -05:00
stats Changed hour maps, fixed #1 2023-10-04 16:58:11 -05:00
.editorconfig Added .editorconfig 2023-09-08 22:52:34 -05:00
.gitignore Added .gitignore 2023-09-05 21:09:51 -05:00
.goreleaser.yaml Removed darwin arm64 2023-10-03 17:39:19 -05:00
go.mod Added go.mod 2023-09-05 21:08:14 -05:00
LICENSE Added LICENSE 2023-10-03 17:44:10 -05:00
main.go Changed hour maps, fixed #1 2023-10-04 16:58:11 -05:00
README.md Update README.md 2025-07-15 14:02:33 -05:00

Shell Time

Shell Time is for your shell, what Screen Time is for your phone!

Shell Time lets you know how much time you and your kids spend on CLIs, TUIs, and more. This way, you can make more informed decisions about how you use your terminals.

Shell Time shows you your top most used commands, the (rough) amount of time you spend in your terminal per day and the hours you seem to be most drawn to the command line! It can give you interesting insights into your shell usage and remind you of long forgotten tools.

TODO: GIFs

Installation

Either download a build from the releases page or clone this repository and run:

go build

or

go install

Configuration

Zsh

Nothing to configure!

Bash

TODO

Usage

shell-time

Example output:


=== YOUR TOP 10 COMMANDS ===
 1. vim (2198 times)
 2. cd (1757 times)
 3. rm (1132 times)
 4. mv (1117 times)
 5. find (1115 times)
 6. ls (888 times)
 7. ga (729 times)
 8. rg (672 times)
 9. cat (655 times)
10. git (605 times)

=== LONG FORGOTTEN COMMANDS ===
 1. dmesg\
 2. head
 3. ks
 4. freecad
 5. lokinet-bootstrap
 6. uuidgen
 7. mbe
 8. docnf
 9. gpoat
10. 27*100

=== MOST PRODUCTIVE HOURS ===
 1. 1:00 (421 commands fired)
 2. 2:00 (188 commands fired)
 3. 21:00 (1643 commands fired)
 4. 22:00 (1216 commands fired)
 5. 0:00 (1048 commands fired)

On average you ran commands on the shell for about 19 minutes per day.