Skip to main content

​
Installation

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

​
System Requirements

  • Go Version: 1.21 or higher (for building from source)
  • Operating Systems: Linux, macOS, Windows
  • Architecture: x86_64, ARM64

​
Installation Methods

  • Binary Download
  • Build from Source
  • Go Install

​
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
  1. 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
  1. 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
  1. Verify the installation:
ahasend --version

​
Platform-Specific Instructions

​
Linux

  • Ubuntu/Debian
  • Fedora/RHEL
  • Arch Linux
# 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 --version

​
macOS

  • Intel Mac
  • Apple Silicon
# 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 --version
On macOS, you may need to allow the binary in Security & Privacy settings if you see a security warning.

​
Windows

  • PowerShell
  • Command Prompt
# 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 (requires admin privileges)
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:LOCALAPPDATA\AhaSend", [EnvironmentVariableTarget]::User)

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

​
Shell Completion

The CLI supports shell completion for bash, zsh, fish, and PowerShell.
  • Bash
  • Zsh
  • Fish
  • PowerShell
Linux:
# Install system-wide (requires sudo)
sudo ahasend completion bash > /etc/bash_completion.d/ahasend

# Or install for current user
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

​
Verifying Installation

After installation, verify that the CLI is working correctly: 
# Check version
ahasend --version

# View help
ahasend --help

# Test API connectivity (after authentication)
ahasend ping

​
Updating the CLI

To update to the latest version:
  • Binary
  • From Source
  • Go Install
Download and replace the existing binary with the latest version from the releases page.

​
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
  1. 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
  1. 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
  1. 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
⌘I