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.
-
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
-
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
- 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
- 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
- Verify the installation:
Build from Source
For the latest features or to contribute to development, build from source.Prerequisites
- Go 1.21 or higher
- Make (optional but recommended)
- Git
Build Steps
- Clone the repository:
git clone https://github.com/AhaSend/ahasend-cli.git
cd ahasend-cli
- Build the CLI:
# Using Make (recommended)
make build
# Or using Go directly
go build -o ahasend ./cmd/ahasend
- Install to your PATH:
# Using Make
sudo make install
# Or manually
sudo cp ./bin/ahasend /usr/local/bin/
- Verify the installation:
Install with Go
If you have Go installed, you can use go install:go install github.com/AhaSend/ahasend-cli/cmd/ahasend@latest
$GOPATH/bin directory. Make sure it’s in your PATH:export PATH=$PATH:$(go env GOPATH)/bin
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
# 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 --version
# 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 --version
macOS
# 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
# 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 --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
:: 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 --version
Shell Completion
The CLI supports shell completion for bash, zsh, fish, and 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
# 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
Linux:# Generate completion script
ahasend completion zsh > "${fpath[1]}/_ahasend"
# Reload shell
exec zsh
# Install to homebrew's zsh completions directory
ahasend completion zsh > $(brew --prefix)/share/zsh/site-functions/_ahasend
# Reload shell
exec zsh
# Generate completion script (works on Linux and macOS)
ahasend completion fish > ~/.config/fish/completions/ahasend.fish
# Reload shell
exec fish
# 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:
# 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. cd ahasend-cli
git pull origin main
make clean build
sudo make install
go install github.com/AhaSend/ahasend-cli/cmd/ahasend@latest
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:
- Check if the binary is in your PATH:
- 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:
- Make sure the binary is executable:
chmod +x /path/to/ahasend
- Use sudo for system-wide installation:
sudo mv ahasend /usr/local/bin/
Version Conflicts
If you have multiple versions installed:
- Check all locations:
- Remove old versions and keep only the latest.
Next Steps
Once installed, you’re ready to:
- Set up authentication
- Start with the quick start guide
- Explore available commands
