Skip to content

Installation

promptcmd can be installed on Linux, macOS, and Windows using several methods. Choose the installation method that works best for your platform.

Linux/macOS (Shell)

The fastest way to install promptcmd on Linux or macOS:

bash
curl -LsSf https://installer.promptcmd.sh | sh

This installer will:

  • Download the latest version for your platform
  • Install the promptcmd and promptctl binaries
  • Add the installation directory to your PATH

macOS (Homebrew)

If you prefer using Homebrew:

bash
brew install tgalal/tap/promptcmd

This method integrates with Homebrew's update system:

bash
# Update promptcmd
brew upgrade promptcmd

Windows (PowerShell)

Run this command in PowerShell

powershell
irm https://installer-ps.promptcmd.sh | iex

This will download and install promptcmd to your system.

Windows (MSI)

Download the MSI installer from the releases page and run it.

  1. Go to GitHub Releases
  2. Download the .msi file for Windows
  3. Double-click to install
  4. Follow the installation wizard

Verifying Installation

After installation, verify that promptcmd is correctly installed by checking the version installed.

bash
promptctl --version

INFO

Depending on the installation method, you may need to restart your shell first.

Troubleshooting

Command Not Found

If you get a "command not found" error after installation, ensure the installation directory is in your PATH:

Linux/macOS

Add this to your ~/.bashrc, ~/.zshrc, or shell config:

bash
export PATH="$HOME/.promptcmd/bin:$PATH"

Then reload your shell:

bash
source ~/.bashrc  # or ~/.zshrc

Windows

The installer should automatically add to PATH. If not:

  1. Search for "Environment Variables" in Windows Settings
  2. Edit your user PATH variable
  3. Add the promptcmd installation directory
  4. Restart your terminal

Permission Denied

On Linux/macOS, if you encounter permission errors:

bash
chmod +x ~/.local/bin/promptcmd ~/.local/bin/promptctl