A blazingly fast command-line tool to analyze your shell history and discover your command usage patterns.
📊 Command Frequency Report (Total: 11084 commands)
────────────────────────────────────────────────────────────
Top Commands
1. git 4970 ████████████████████
2. go 1410 █████
3. docker 652 ██
4. cd 565 ██
5. code 514 ██
- 📊 Frequency Analysis - See which commands you use most
- 🔍 Deep Filtering - Drill down into specific commands and subcommands
- 🎨 Beautiful Output - Colorful terminal output with bar charts
- 📁 Subcommand Stats - Discover your most used subcommand patterns
- 🚩 Flag Patterns - See which flags you use most frequently
- 📤 JSON Export - Export reports for further analysis
- ⚡ Streaming - Processes history via stdin for maximum portability
go install ella.to/[email protected]Make sure $GOPATH/bin (or $HOME/go/bin) is in your PATH.
Pipe your shell history to hismetric:
# Basic usage - show top commands
history | hismetric
# For zsh users (recommended for full history)
cat ~/.zsh_history | hismetric
# For bash users
cat ~/.bash_history | hismetricUse -q to filter and analyze specific commands:
# Analyze all git commands
history | hismetric -q git
# Analyze git commit specifically
history | hismetric -q "git commit"
# Go deeper - analyze git remote add
history | hismetric -q "git remote add"
# Analyze docker run patterns
history | hismetric -q "docker run"$ cat ~/.zsh_history | hismetric
📊 Command Frequency Report (Total: 11084 commands)
────────────────────────────────────────────────────────────
Top Commands
1. git 4970 ████████████████████
2. go 1410 █████
3. docker 652 ██
4. cd 565 ██
5. code 514 ██
...$ cat ~/.zsh_history | hismetric -q git
📊 Report for: git
────────────────────────────────────────────────────────────
Total occurrences: 4970
Usage Patterns
git commit 1248 ███████████████
git status 1067 ████████████
git add . 507 ██████
git push origin main 124 █
git checkout 146 █
...$ cat ~/.zsh_history | hismetric -q "git commit"
📊 Report for: git commit
────────────────────────────────────────────────────────────
Total occurrences: 1253
Command: git commit
Frequency: 1250
🚩 Top 10 Flag Patterns
-m=Clean up code 30 ████████
-m=Update the code 10 ███
-m=wip 9 ██
-m=First init 4 █
...| Flag | Description |
|---|---|
-q <query> |
Filter commands (e.g., git, git commit, docker run) |
--all |
Show all results instead of top 25 |
--asc |
Sort by frequency ascending (least used first) |
--desc |
Sort by frequency descending (default) |
--json |
Output as JSON for programmatic use |
--no-color |
Disable colored output |
# Show least used commands first
history | hismetric --asc
# Show all commands, not just top 25
history | hismetric --all
# Combine: all commands, least used first
history | hismetric --all --ascExport your analysis as JSON for further processing:
$ cat ~/.zsh_history | hismetric --json
{
"total_commands": 11084,
"commands": [
{
"command": "git",
"count": 4970,
"subcommands": [
{"name": "commit", "count": 1252},
{"name": "status", "count": 1070},
{"name": "add", "count": 776}
]
}
]
}Filter and export:
# Export git analysis to file
cat ~/.zsh_history | hismetric -q git --json > git-analysis.json
# Pipe to jq for further processing
cat ~/.zsh_history | hismetric --json | jq '.commands[:5]'Add an alias to your ~/.zshrc:
alias hm='cat ~/.zsh_history | hismetric'
alias hmq='cat ~/.zsh_history | hismetric -q'
# Usage:
# hm - show all command frequencies
# hmq git - show git patterns
# hmq "git commit" - show git commit patternsAdd to your ~/.bashrc:
alias hm='cat ~/.bash_history | hismetric'
alias hmq='cat ~/.bash_history | hismetric -q'Add to your ~/.config/fish/config.fish:
alias hm='cat ~/.local/share/fish/fish_history | hismetric'hismetric parses shell history from stdin and:
- Tokenizes each command into name, subcommands, and flags
- Normalizes flags (sorted for consistent comparison)
- Aggregates by command pattern based on your query
- Displays frequency statistics with visual bar charts
It handles various history formats including:
- Plain command history (
historyoutput) - Zsh extended history (
: timestamp:duration;command) - Heredocs and multi-line commands
- Quoted and escaped arguments
- 🔍 Discover Habits - Find out which commands you use most
- 📈 Track Patterns - See how your git commit messages evolve
- 🎯 Optimize Workflow - Identify commands worth aliasing
- 📊 Team Insights - Share usage patterns with your team (via JSON)
- 🧹 Clean Up - Find one-off commands cluttering your history
MIT
Contributions are welcome! Please feel free to submit issues and pull requests.