CmdBook is a terminal-based command manager that helps you organize, search, and execute your frequently used CLI commands through an interactive TUI (Text User Interface).
It is designed for developers and Linux users who frequently customize their workflow and want a reliable way to store and reuse commands.
- Interactive TUI with keyboard navigation
- Add, edit, and delete commands
- Run commands directly from the interface
- Persistent storage using JSON
- Lightweight and fast
- Clean and minimal interface
- Automatic data directory creation (no manual setup required)
| Key | Action |
|---|---|
| Up / Down | Navigate |
| Enter | Select |
| Ctrl + A | Add command |
| Ctrl + E | Edit command |
| Ctrl + D | Delete |
| Ctrl + R | Run command |
- Store frequently used Linux commands
- Manage development shortcuts
- Keep track of automation scripts
- Build a personal command knowledge base
git clone https://github.com/arifinsiddiqzisan/cmdbook.git
cd cmdbook
pip install textual rich
sudo mv cmdbook.py /usr/local/bin/cmdbook
sudo chmod +x /usr/local/bin/cmdbook
cmdbookOn first run, CmdBook will automatically create the required data directory.
mkdir -p ~/.local/bin
mv cmdbook.py ~/.local/bin/cmdbook
chmod +x ~/.local/bin/cmdbook
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
cmdbook- Clone the repository:
git clone https://github.com/arifinsiddiqzisan/cmdbook.git
cd cmdbook- Install dependencies:
pip install textual rich- Create a tools directory:
mkdir C:\tools- Move the script:
move cmdbook.py C:\tools\cmdbook.py- Create a batch file (
cmdbook.bat) insideC:\tools\:
@echo off
python C:\tools\cmdbook.py %*- Add
C:\toolsto Environment Variables:
- Open System Properties
- Go to Environment Variables
- Edit
Path - Add:
C:\tools
- Run:
cmdbookCmdBook will automatically create its data directory on first run.
- Python 3
- pip
Linux:
sudo apt install python3-pip
pip install textual richWindows:
pip install textual richCmdBook stores all commands in an OS-specific location:
Linux:
~/.cmdbook/commands.json
Windows:
C:\Users\YourName\cmdbook\commands.json
The directory and file are created automatically on first run.
Name: pyenv
Command: pyenv
Description: Manage Python virtual environments
- Python
- Textual
- Rich
CmdBook is built with a simple idea:
Your terminal should remember what you forget.
Instead of searching for commands repeatedly, store them once and access them instantly.
MIT License
Contributions are welcome. You can:
- Open issues
- Suggest features
- Submit pull requests
Arifin Siddiq Zisan