Shellist

Parse .bash_history, count commands, rank by frequency. Library and CLI.

Install

cargo install shellist

CLI

shellist                   # reads ~/.bash_history, prints ranked table
shellist --top 5           # top 5 only
shellist --ignore ls,cd    # exclude ls and cd
shellist --min 3           # only commands used ≥ 3 times
shellist --path ./my_history.txt

Options:

Example output:

Rank  Command  Count
----  -------  -----
   1  ls          120
   2  git          95
   3  cd           80

Library

use shellist::{analyze, parse_history, count_commands, rank_commands,
                top_n, filter_commands, filter_by_min_frequency,
                load_history_file, default_history_path};

// Full pipeline
let ranked = analyze("ls\ngit\nls\ncd\ngit\nls");
assert_eq!(ranked, vec![
    ("ls".to_string(), 3),
    ("git".to_string(), 2),
    ("cd".to_string(), 1),
]);

// Step by step
let entries = parse_history("git push\ncd /\ngit commit");
let counts = count_commands(&entries);
let ranked = rank_commands(counts);
let top = top_n(ranked, 2);
let filtered = filter_commands(top, &["cd"]);

// From file
let content = load_history_file("/home/user/.bash_history")?;

Benchmarks

cargo bench

Runs criterion benchmarks on analyze() with 100, 1k, 10k, and 100k history entries. Results are written to target/criterion/ with HTML reports.

To compare against a baseline:

cargo bench -- --save-baseline before
# make changes...
cargo bench -- --baseline before

License

MIT