Install the AhaSend CLI (macOS, Linux, Windows)

Install the AhaSend CLI on macOS, Linux, or Windows from a prebuilt binary, with go install, or from source, then enable shell completion and verify it works.

The AhaSend CLI can be installed through multiple methods. Choose the one that best fits your system and workflow.

System Requirements

• Go Version: 1.26.1 or later (for building from source)
• Operating Systems: Linux, macOS, Windows | Platform | Prebuilt architectures | |---|---| | macOS | x86_64 and ARM64 | | Linux | x86_64 | | Windows | x86_64 |

Linux and Windows ARM64 require go install or a source build.

Installation Methods

Binary Download

Download Pre-built Binary

The quickest way to get started is to download a pre-built binary for your platform.

1. Download the appropriate binary for your platform from the GitHub releases page:

   • Linux x64: ahasend-linux-amd64
   • macOS Intel: ahasend-darwin-amd64
   • macOS Apple Silicon: ahasend-darwin-arm64
   • Windows x64: ahasend-windows-amd64.exe

2. Rename and make executable (Linux/macOS):

# Linux
mv ahasend-linux-amd64 ahasend
chmod +x ahasend

# macOS Intel
mv ahasend-darwin-amd64 ahasend
chmod +x ahasend

# macOS Apple Silicon
mv ahasend-darwin-arm64 ahasend
chmod +x ahasend

3. Move to your PATH:

# Linux/macOS
sudo mv ahasend /usr/local/bin/

# Or add to your user bin directory
mkdir -p ~/.local/bin
mv ahasend ~/.local/bin/
# Add ~/.local/bin to your PATH if not already there

4. For Windows:

# Rename to remove platform suffix (optional)
ren ahasend-windows-amd64.exe ahasend.exe

# Move to a directory in your PATH or add current directory to PATH

5. Verify the installation:

ahasend --help

Build from Source

Build from Source

Build the public source to contribute or target another supported platform. Contacts require a later CLI release; the supplied local development build includes them, but public v0.2.0 and its current public source do not.

Prerequisites

• Go 1.26.1 or later
• Make (optional but recommended)
• Git

Build Steps

1. Clone the repository:

git clone https://github.com/AhaSend/ahasend-cli.git
cd ahasend-cli

2. Build the CLI:

# Using Make (recommended)
make build

# Or using Go directly
go build -o bin/ahasend .

3. Install to your PATH:

# Using Make
sudo cp bin/ahasend /usr/local/bin/ahasend

# Or manually
sudo cp ./bin/ahasend /usr/local/bin/

4. Verify the installation:

ahasend --help

Go Install

Install with Go

If you have Go installed, you can use go install:

go install github.com/AhaSend/ahasend-cli@latest

This installs a binary named ahasend-cli into GOBIN, or $(go env GOPATH)/bin when GOBIN is unset. Rename it to ahasend to use the commands in these docs. With the default Go bin directory:

mv "$(go env GOPATH)/bin/ahasend-cli" "$(go env GOPATH)/bin/ahasend"

Make sure that directory is in your PATH:

export PATH=$PATH:$(go env GOPATH)/bin

Verify the Download

Download the binary and checksums.txt from the same release. On Linux, verify the binary before installing it:

sha256sum --ignore-missing --check checksums.txt

On macOS, use shasum -a 256 ahasend-darwin-arm64 (or the Intel filename) and compare its result to the matching line in checksums.txt. The releases page lists the current version.

Platform-Specific Instructions

Linux

Ubuntu/Debian

# Download the binary
wget https://github.com/AhaSend/ahasend-cli/releases/latest/download/ahasend-linux-amd64

# Make executable and install
chmod +x ahasend-linux-amd64
sudo mv ahasend-linux-amd64 /usr/local/bin/ahasend

# Verify
ahasend --help

Fedora/RHEL

# Download the binary
curl -LO https://github.com/AhaSend/ahasend-cli/releases/latest/download/ahasend-linux-amd64

# Make executable and install
chmod +x ahasend-linux-amd64
sudo mv ahasend-linux-amd64 /usr/local/bin/ahasend

# Verify
ahasend --help

Arch Linux

# Download the binary
wget https://github.com/AhaSend/ahasend-cli/releases/latest/download/ahasend-linux-amd64

# Install to user directory
mkdir -p ~/.local/bin
mv ahasend-linux-amd64 ~/.local/bin/ahasend
chmod +x ~/.local/bin/ahasend

# Add to PATH if needed
echo 'export PATH=$PATH:~/.local/bin' >> ~/.bashrc
source ~/.bashrc

# Verify
ahasend --help

macOS

Intel Mac

# Download the binary
curl -LO https://github.com/AhaSend/ahasend-cli/releases/latest/download/ahasend-darwin-amd64

# Make executable and install
chmod +x ahasend-darwin-amd64
sudo mv ahasend-darwin-amd64 /usr/local/bin/ahasend

# Verify
ahasend --help

Apple Silicon

# Download the binary
curl -LO https://github.com/AhaSend/ahasend-cli/releases/latest/download/ahasend-darwin-arm64

# Make executable and install
chmod +x ahasend-darwin-arm64
sudo mv ahasend-darwin-arm64 /usr/local/bin/ahasend

# Verify
ahasend --help

On macOS, you may need to allow the binary in Security & Privacy settings if you see a security warning.

Windows

PowerShell

# Download the binary
Invoke-WebRequest -Uri "https://github.com/AhaSend/ahasend-cli/releases/latest/download/ahasend-windows-amd64.exe" -OutFile "ahasend.exe"

# Create a directory for the CLI
New-Item -ItemType Directory -Force -Path "$env:LOCALAPPDATA\AhaSend"

# Move the executable
Move-Item -Path ".\ahasend.exe" -Destination "$env:LOCALAPPDATA\AhaSend\ahasend.exe"

# Add to PATH (User scope; no admin rights needed)
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:LOCALAPPDATA\AhaSend", [EnvironmentVariableTarget]::User)

# Verify (open new PowerShell window)
ahasend --help

Command Prompt

:: Download using curl (Windows 10+)
curl -LO https://github.com/AhaSend/ahasend-cli/releases/latest/download/ahasend-windows-amd64.exe

:: Create directory
mkdir "%LOCALAPPDATA%\AhaSend"

:: Move executable
move ahasend-windows-amd64.exe "%LOCALAPPDATA%\AhaSend\ahasend.exe"

:: Add to PATH manually through System Properties > Environment Variables
:: Add %LOCALAPPDATA%\AhaSend to your PATH

:: Verify (open new command prompt)
ahasend --help

Shell Completion

The CLI supports shell completion for bash, zsh, fish, and PowerShell.

Bash

Linux:

# Install system-wide (requires sudo)
sudo mkdir -p /etc/bash_completion.d
ahasend completion bash | sudo tee /etc/bash_completion.d/ahasend > /dev/null

# Or install for current user
mkdir -p ~/.bash_completion.d
ahasend completion bash > ~/.bash_completion.d/ahasend
echo "source ~/.bash_completion.d/ahasend" >> ~/.bashrc
source ~/.bashrc

macOS:

# Install system-wide (requires brew and bash-completion)
brew install bash-completion
ahasend completion bash > $(brew --prefix)/etc/bash_completion.d/ahasend

# Reload shell
exec bash

Zsh

Linux:

# Install completion for your user
mkdir -p ~/.zsh/completions
ahasend completion zsh > ~/.zsh/completions/_ahasend
echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -Uz compinit && compinit' >> ~/.zshrc

# Reload shell
exec zsh

macOS:

# Install to homebrew's zsh completions directory
ahasend completion zsh > $(brew --prefix)/share/zsh/site-functions/_ahasend

# Reload shell
exec zsh

Fish

# Generate completion script (works on Linux and macOS)
mkdir -p ~/.config/fish/completions
ahasend completion fish > ~/.config/fish/completions/ahasend.fish

# Reload shell
exec fish

PowerShell

# Generate completion script
ahasend completion powershell > ahasend.ps1

# Source it in your profile
Add-Content $PROFILE "& $(Get-Location)\ahasend.ps1"

# Reload profile
. $PROFILE

Verifying Installation

After installation, verify that the CLI is working correctly:

# View help
ahasend --help

# Test API connectivity (after authentication)
ahasend ping

Updating the CLI

To update to the latest version:

Binary

Download and replace the existing binary with the latest version from the releases page.

From Source

cd ahasend-cli
git pull origin main
make clean build
sudo cp bin/ahasend /usr/local/bin/ahasend

Go Install

go install github.com/AhaSend/ahasend-cli@latest
mv "$(go env GOPATH)/bin/ahasend-cli" "$(go env GOPATH)/bin/ahasend"
"$(go env GOPATH)/bin/ahasend" --help

Uninstallation

To remove the AhaSend CLI from your system:

# Remove the binary
sudo rm /usr/local/bin/ahasend

# Remove configuration (optional)
rm -rf ~/.ahasend

# Remove shell completions (if installed)
# Location depends on your shell and installation method

Troubleshooting

Command Not Found

If you get “command not found” after installation:

1. Check if the binary is in your PATH:

which ahasend

2. If not found, add the installation directory to your PATH:

# For bash
echo 'export PATH=$PATH:/usr/local/bin' >> ~/.bashrc
source ~/.bashrc

# For zsh
echo 'export PATH=$PATH:/usr/local/bin' >> ~/.zshrc
source ~/.zshrc

Permission Denied

If you get permission errors:

1. Make sure the binary is executable:

chmod +x /path/to/ahasend

2. Use sudo for system-wide installation:

sudo mv ahasend /usr/local/bin/

Version Conflicts

If you have multiple versions installed:

1. Check all locations:

which -a ahasend

2. Remove old versions and keep only the latest.

Next Steps

Once installed, you’re ready to:

1. Set up authentication
2. Start with the quick start guide
3. Explore available commands

Related Guides

• CLI authentication, REST sending guide, SMTP settings.
• Node.js SDK, Go SDK, CLI configuration and output.
• API authentication, Permission scopes.