Project
Roulette

Shell History Insights

Your most-typed commands, and the aliases you should have made months ago.

BeginnerCommand lineProductivity5–12hAI-buildable 5/5no setupworth shipping

What you're making

Reads your shell history and shows what you actually type all day. The useful bit is the suggestions: it spots the long commands you run constantly and writes the alias for you, ready to paste. Most people find two or three that save them real time every single day.

Analyses shell history for frequency and length, then proposes aliases weighted by time saved. Parsing several history formats and scoring which commands are worth aliasing is the substance.

UI
Logic
Useful

Hosting · Free forever

Deploys free on npm, PyPI or GitHub Releases.

Nothing to host. Publishing to a package registry is free and permanent, and anyone can run it with a single command.

Publish to npm — one command and anyone can run it.

Core features · 7

  • Reads history from bash, zsh and fish formats
  • Ranks commands by how often you run them
  • Suggests aliases for long, frequent commands
  • Ranks suggestions by total keystrokes saved
  • Prints ready-to-paste alias definitions
  • Excludes anything that looks like a secret or a token
  • Shows a usage-by-hour chart of your day

The interesting part

  • Every shell stores history in a different format, some with timestamps and some without
  • Filtering out secrets that people paste into commands
  • Scoring which commands are genuinely worth aliasing rather than just frequent

Once it works

  • Detect command sequences worth turning into a script
  • Add a typo report of commands you frequently mistype
  • Track improvement after adopting aliases

Suggested stack

typescriptnodecommander

Track it