Skip to main content

​
Quick Install

Install Ahh CLI with a single command: 
curl -fsSL https://cli.ahh.bet/install.sh | bash
After installation, reload your shell configuration: 
source ~/.bashrc
Verify the installation: 
ahh --help

​
Requirements

Before installing Ahh CLI, ensure you have the following dependencies:
1

curl

Required for downloading the installation script and CLI binary.Most systems have curl pre-installed. Verify with:
curl --version
2

cloudflared

Required for creating tunnels with the tunnel and serve commands.
The tunnel feature uses Cloudflare’s free tunnel service to expose local ports to the internet.
Install cloudflared:
brew install cloudflare/cloudflare/cloudflared

​
Manual Installation

If you prefer to install manually:
1

Download the binary

Download the appropriate archive for your operating system:
mkdir -p ~/.ahh/bin
curl -L -o ~/.ahh/ahh-dist-linux.tar.gz \
  https://github.com/abhishekg999/ahh/releases/latest/download/ahh-dist-linux.tar.gz
2

Extract and install

tar -xzf ~/.ahh/ahh-dist-linux.tar.gz -C ~/.ahh
rm ~/.ahh/ahh-dist-linux.tar.gz
chmod +x ~/.ahh/bin/ahh
3

Add to PATH

Add the following to your shell configuration file:
# ahh
export AHH_HOME="$HOME/.ahh"
export PATH="$HOME/.ahh/bin:$PATH"
4

Reload shell

Apply the changes:
source ~/.bashrc

​
Shell Completions

The installation script automatically sets up shell completions. If you installed manually, add completions with:
1

Generate completion script

AHH_COMPLETIONS=1 ~/.ahh/bin/ahh > ~/.ahh/_ahh
2

Load completions

Add to your shell configuration:
# ahh completions
[ -s "$HOME/.ahh/_ahh" ] && source "$HOME/.ahh/_ahh"
Shell completions provide tab-completion for commands and options, improving your workflow efficiency.

​
Updating

Update to the latest version of Ahh CLI: 
ahh update
This command automatically downloads and installs the latest release.

​
Troubleshooting

If you encounter “command not found” errors after installation, ensure you’ve reloaded your shell configuration or opened a new terminal window.

​
Unsupported Shell

If you’re using a shell other than bash, zsh, or fish, manually add the following to your shell configuration: 
export AHH_HOME="$HOME/.ahh"
export PATH="$HOME/.ahh/bin:$PATH"
[ -s "$HOME/.ahh/_ahh" ] && source "$HOME/.ahh/_ahh"

​
Cloudflared Not Found

If tunnel commands fail with “cloudflared not found”:
  1. Verify cloudflared is installed: cloudflared --version
  2. Ensure cloudflared is in your PATH
  3. Reinstall cloudflared using the instructions in the Requirements section

​
Uninstalling

To remove Ahh CLI: 
rm -rf ~/.ahh
Then remove the configuration lines from your shell config file (~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish).

Build docs developers (and LLMs) love

Get started for freeTalk to us