Profile
Back to NewsBack
GitHub Trending 3 min
Reader Mode
Mojo8898/aliasr: Aliasr is a modern, feature-rich TUI launcher for pentest commands.

Mojo8898/aliasr: Aliasr is a modern, feature-rich TUI launcher for pentest commands.

14 hours ago

Aliasr

PyPI version</a> !Python !License

Aliasr is a modern, feature-rich TUI launcher for penetration testing commands inspired by Arsenal, but with significantly improved functionality.

Aliasr Quick Guide</a>

Features

Some of the largest improvements Aliasr implements include:

  • [x] Significantly expanded tmux integration.
  • [x] Cheat variations that allow for different authentication methods to be built into a single parameter.
  • [x] Automatic parameter population based on history and other sources.
  • [x] Exegol-history (SQLite) integration for parameter management.

Install

# Latest release (PyPI)
uv tool install aliasr
pipx install aliasr

Latest commit (GitHub)

uv tool install git+https://github.com/Mojo8898/aliasr pipx install git+https://github.com/Mojo8898/aliasr

I also highly recommend adding the following line to your ~/.zshrc:

alias a=aliasr

If you intend on leveraging the extended tmux integration aliasr offers (which you should), also add the following to your ~/.tmux.conf:

# Add to ~/.tmux.conf
bind U split-window "aliasr send -pp"
bind K split-window "aliasr -e send -pp"

Recommended tmux settings

set -s escape-time 0 set -s focus-events on set -s default-terminal "tmux-256color" set -as terminal-overrides ",*:Tc"

You can now use the prefix+K hotkey to open aliasr below the current pane and send commands automatically to the pane that was focused previously. prefix+U does the same but without also sending the enter key to execute the command.

Usage

$ aliasr -h
usage: aliasr [-h] [-e] {audit,send,scan,list,clear} ...

aliasr - Modern TUI launcher for pentest commands

positional arguments: {audit,send,scan,list,clear} audit Audit cheatsheets and configs send Modify how commands are sent scan Auto-populate globals from a target IP list List globals or credentials clear Clear session data

options: -h, --help show this help message and exit -e, --exec Execute the command immediately

Note: Almost all hotkeys can be found in the footer of the application when running.

Configuration

Aliasr allows you to configure pretty much everything. Refer to the built-in config.toml found here to see what configurations options are available. A detailed configuration guide can be found in Configuration.

Edit ~/.aliasr/config.toml (created automatically on first run) to override any defaults; your changes are merged at runtime.

Cheats

A detailed reference guide on writing cheats can be found here.

Contributing

Contributions are welcome but make sure you if you are contributing to cheats, you follow guidelines in Cheats. Also feel free to open an issue if you want to add other features.

Detailed development setup instructions can be found in the official Textual documentation.

Acknowledgments

  • Inspired by Arsenal by Orange Cyberdefense
  • Built with Textual
  • Special thanks to all members of my HackTheBox team S4U2SelfEnjoyers for beta testing and providing essential feedback.
Chat with me