Toolbox - Terminal Command Manager

Save, organize, and execute your most-used terminal commands

Features • Installation • Usage • Screenshots • Configuration

Overview

Toolbox is a powerful terminal utility that helps you save and organize your frequently used commands. Stop wasting time trying to remember or searching your shell history for that complex command you use occasionally.

With Toolbox, you can:

• Store commands with descriptions and categories
• Browse and filter commands by category
• Run commands directly from a user-friendly TUI (Terminal User Interface)
• Import and export command collections to share with others

Warning

Toolbox is still in alpha development. Expect bugs and breaking changes.

Features

• Easy Command Management: Add, modify, and delete commands with simple syntax
• Category Organization: Group commands by categories for better organization
• Search Functionality: Quickly find commands by name or description
• Interactive TUI Mode: Full-screen terminal interface with vim-like navigation
• Export/Import: Share your command collections with others
• Vim-style Navigation: Familiar keybindings for efficient keyboard navigation

Installation

Prerequisites

Toolbox requires:

• Bash shell (tested with zsh)
• jq for JSON processing
• fzf (optional, enhances TUI experience)

Quick Install

# Clone the repository
git clone https://github.com/lucolvin/Toolbox_TUI.git

# Make the script executable
chmod +x Toolbox_TUI/toolbox.sh

# Create a symlink (optional, for easier access)
ln -s "$(pwd)/Toolbox_TUI/toolbox.sh" /usr/local/bin/toolbox

Usage

TUI Mode (Recommended)

The easiest way to use Toolbox is through its Terminal User Interface:

toolbox

Navigate with:

• j/k or arrow keys: Move up/down
• Enter: Select
• q or Esc: Back/Exit

Command Line Usage

# Add a new command
toolbox add list-ports "lsof -i -P -n | grep LISTEN" -d "List all listening ports" -c "network"

# List all commands
toolbox list

# List commands in a specific category
toolbox list -c network

# Run a command
toolbox run list-ports

# Delete a command
toolbox delete list-ports

Command Reference

Command	Description
toolbox	Start full-screen terminal user interface
add NAME COMMAND [-d DESCRIPTION] [-c CATEGORY]	Add a new command shortcut
list [-c CATEGORY] [-s SEARCH]	List saved commands
run NAME	Run a saved command
delete NAME	Delete a command
modify NAME [-cmd COMMAND] [-d DESCRIPTION] [-c CATEGORY]	Modify an existing command
categories	List all available categories
export [FILENAME] [-c CATEGORY]	Export commands to a file
import FILENAME	Import commands from a file
help	Show help message

Screenshots

TUI Mode - Main Menu

Browsing Commands

Configuration

Toolbox stores its configuration and command database in ~/.toolbox/:

• ~/.toolbox/commands.json: The command database
• ~/.toolbox/exports/: Directory for exported command collections

Advanced Usage

Categories

Organize your commands with categories:

# List all categories
toolbox categories

# Add a command to a specific category
toolbox add ssh-server "ssh user@server.example.com" -c "servers"

# List only commands in a specific category
toolbox list -c servers

Exporting and Importing

Share your command collection with others:

# Export all commands
toolbox export my_commands

# Export only commands in a specific category
toolbox export network_commands -c network

# Import commands from a file
toolbox import my_commands.json

License

This project is licensed under the MIT License - see the LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

---

Made with ❤️ by Luke's Labs