Skip to content

yangstafiltra/ShellWeCount

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 

Repository files navigation

ShellWeCount

A terminal-based command history timeline visualizer / 基于终端的命令历史时间线可视化工具


English

ShellWeCount analyzes your shell history and displays it as a visual timeline with:

  • Top Commands Ranking - See your most frequently used commands
  • Category Breakdown - Commands grouped by type (git, npm, docker, python, etc.)
  • Density Heatmap - Visualize command activity over time
  • Command List - Chronological list of all commands with color coding

Installation

npm install -g shellwecount

Usage

shellwecount [options]

Options

Option Description Default
-r, --range <range> Time range: today, yesterday, week, month today
-f, --format <format> Display format: both, top, stats, density, list both
-t, --top <count> Show top N commands 10
-l, --lang <lang> Language: en, zh auto-detect
-h, --help Show help -

Examples

shellwecount                          # Today's full view
shellwecount -r week -f top           # This week's top 10 commands
shellwecount -r month -t 20 -f top    # This month's top 20
shellwecount -r week -f stats         # Weekly stats + category breakdown
shellwecount -r today -f density      # Today's density heatmap
shellwecount -l en -r today           # English output

中文

ShellWeCount 分析你的 shell 历史记录并以可视化时间线展示:

  • 常用命令排名 - 查看你最常用的命令
  • 命令分类统计 - 按类型分组(git、npm、docker、python 等)
  • 密度热力图 - 直观展示命令活动时段
  • 命令列表 - 按时间排序的命令列表,带颜色分类

安装

npm install -g shellwecount

用法

shellwecount [选项]

选项

选项 说明 默认值
-r, --range <范围> 时间范围: today, yesterday, week, month today
-f, --format <格式> 显示格式: both, top, stats, density, list both
-t, --top <数量> 显示排名前N的命令 10
-l, --lang <语言> 语言: en, zh 自动检测
-h, --help 显示帮助 -

示例

shellwecount                          # 今天的完整视图
shellwecount -r week -f top           # 本周常用命令TOP10
shellwecount -r month -t 20 -f top    # 本月TOP20
shellwecount -r week -f stats         # 本周统计+分类
shellwecount -r today -f density      # 今天密度热力图
shellwecount -l zh -r today           # 中文输出

License

MIT

Author

yangsta


AI Declaration / AI 声明

English: This project was developed with the assistance of AI coding tools

中文: 本项目在开发过程中使用了AI编程辅助工具

About

基于终端的命令历史时间线可视化工具 A terminal-based command history timeline visualizer

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors