The power of dynamic binaries at your fingertips.
Shortk is a blazing-fast command-line shortcut manager written in Go. Unlike traditional shell aliases, Shortk generates real executables in your PATH, enabling instant usage across all terminal tabs without sourcing configuration files.
Installation
Install Shortk directly via curl. The script automatically detects your OS and architecture.
Shortk is fully compatible with Linux, macOS, and Windows.
After installation, reload your shell profile or restart your terminal to apply changes:
source ~/.zshrc, source ~/.bashrc, or restart your PowerShell terminal.
Updating
Keep Shortk up to date by simply re-running the installation command. The script will automatically fetch and install the latest pre-built binary.
Getting Started
Initialize the environment and add your first shortcut.
1. Initialize
Sync existing wrappers and ensure shell integration is active.
shortk init 2. Add a Shortcut
Map a long command to a concise name.
shortk add hello 'echo "hello from shortk"' 3. Execute
Call it directly from any directory.
hello Core Commands
shortk init Set up shell integration and sync dynamic wrappers.
shortk add <short> <long> Register a new shortcut globally.
shortk remove <short> Delete a shortcut and its associated dynamic binary.
shortk list List all currently registered shortcuts.
shortk status <short> Inspect where a shortcut is defined and detect scope overrides.
shortk version Show current Shortk version.
Local vs Global Scope
Shortk supports directory-specific shortcuts using the --local flag. This creates a .shortk file in your current directory.
Automatic .env Injection
Dynamic wrappers automatically detect .env files in the current directory and inject their variables into the command context at runtime.
~/.env: DB_PORT=5432
shortk add db-shell "psql -p $DB_PORT"
→ Dynamic Wrapper sources .env before execution
Uninstallation
Completely remove Shortk and its dynamic binaries from your system.