topalias

topalias - Linux alias generator from bash/zsh command history with statistics, written on Python.

Features

Generate short alias for popular command from bash/zsh shell history
Command history statistics & analytics
Parametrised input
Console help for all commands, options and arguments
Shell workflow hints

Installation

pip3 install -U --user topalias

From source:

git clone https://github.com/CSRedRat/topalias
python3 topalias/setup.py install --user

Run as python script without install:

git clone https://github.com/CSRedRat/topalias
python3 topalias/topalias/cli.py -h

Install requirements

sudo apt install python3 python3-pip -y

Add PATH environment variable for run Python tools as Linux utility:

echo "export PATH=$PATH:$HOME/.local/bin" >> ~/.bashrc
source ~/.bashrc

Usage

generated bash aliases

Without parameters utility check if you use alias in ~/.bash_aliases - analyze and print usage statistics, then find new simple aliases

python3 -m topalias  # run as python module
topalias  # check aliases and print suggestion bash command history
topalias -h  # print help
topalias --zsh  # work with zsh shell command history
topalias --min=2  # set minimal length for generated acronym filter, so that exclude some short command and find long, hard, usable command
topalias --debug history  # only analyze local bash history and print filtered rows

Files path search order:

directory from execution parameter
.bash_history in . current directory
.bash_history in ~ user home directory
example development files in topalias/data

You can change dot files search path to another user home directory:

topalias -f /home/user  # or topalias --path /home/user

Also you can use topalias utility in Bash for Git on Windows and in WSL.

Documentation

Usage: topalias [OPTIONS] COMMAND [ARGS]

Options:
  -l, --min INTEGER     Print alias acronym not less that value. Default: 1
  -c, --count INTEGER   Print specified number acronym suggestions. Default:
                        20

  --filter              Filter used aliases in history. Default: False
  -z, --zsh             Use zsh shell history file .zsh_history. Default:
                        False

  -f, --path TEXT       Change custom directory for files: .bash_aliases,
                        .bash_history, .zsh_history

  --version             Print current program version and check latest on
                        pypi.org.

  --debug / --no-debug  Enable debug strings in output.
  -h, --help            Show this message and exit.

Commands:
  hint     Print all hints.
  history  Print bash history file.
  version  Get program current and available version.

TODO

check if alias name already used
check if alias already added
add any another acronym algorithm with semantic
more statistics & analytics (used dir, utils, parameters, time)
alias max length parameter
command ignore list flag: top, emacs, vim
often used command "ssh username@servername" suggest add to .ssh/config/

License

GPLv3

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{Sergey Chudakov}
💻 🚇 🤔 🚧 📦

_{Sergey Morozik}
🚧 📦💻

GitLab repository mirror with CI/CD: https://gitlab.com/CSRedRat/topalias

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

topalias-4.3.1.tar.gz (30.4 kB view details)

Uploaded Nov 16, 2025 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

topalias-4.3.1-py2.py3-none-any.whl (33.8 kB view details)

Uploaded Nov 16, 2025 Python 2Python 3

File details

Details for the file topalias-4.3.1.tar.gz.

File metadata

Download URL: topalias-4.3.1.tar.gz
Upload date: Nov 16, 2025
Size: 30.4 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: poetry/2.2.1 CPython/3.10.11 Windows/10

File hashes

Hashes for topalias-4.3.1.tar.gz
Algorithm	Hash digest
SHA256	`7cf5daeebca419b0a4ea5715f7da3f79d507694108675cfbb2012f1da037ec3b`
MD5	`49577de4476ca6647e80eb1a60a1b59c`
BLAKE2b-256	`fbdcc3cbff0be0cad5be6b915c99f8565f71bb7b9dbe37a277b4d93383d0ea5a`

See more details on using hashes here.

File details

Details for the file topalias-4.3.1-py2.py3-none-any.whl.

File metadata

Download URL: topalias-4.3.1-py2.py3-none-any.whl
Upload date: Nov 16, 2025
Size: 33.8 kB
Tags: Python 2, Python 3
Uploaded using Trusted Publishing? No
Uploaded via: poetry/2.2.1 CPython/3.10.11 Windows/10

File hashes

Hashes for topalias-4.3.1-py2.py3-none-any.whl
Algorithm	Hash digest
SHA256	`f99a24b620249bc3f9539b05682fa6e9970fde094745d65c76916750eef2a06c`
MD5	`71a02980235f32d9751981ca7efc630f`
BLAKE2b-256	`d48e2af8c78619ab7522229aa6bc168a0b7e16c322220ef418b0b32150df954d`