macOS Installation

Quick Install

The fastest way to install on macOS:

curl -sSL https://epochproxy.cloud/install.sh | bash

Supported Platforms

Architecture	Binary
Intel (x86_64)	`epoch-agent-darwin-amd64`
Apple Silicon (M1/M2/M3)	`epoch-agent-darwin-arm64`

The installer automatically detects your architecture, including Rosetta 2 emulation.

Manual Installation

1. Download the Binary

# For Intel Macs
curl -LO https://epochproxy.cloud/releases/v0.1.0/epoch-agent-darwin-amd64

# For Apple Silicon (M1/M2/M3)
curl -LO https://epochproxy.cloud/releases/v0.1.0/epoch-agent-darwin-arm64

2. Verify the Checksum (Recommended)

# Download the checksum
curl -LO https://epochproxy.cloud/releases/v0.1.0/epoch-agent-darwin-arm64.sha256

# Verify
shasum -a 256 -c epoch-agent-darwin-arm64.sha256

3. Remove Quarantine Attribute

macOS Gatekeeper may block unsigned binaries. Remove the quarantine attribute:

xattr -d com.apple.quarantine epoch-agent-darwin-arm64

4. Install the Binary

# Make executable
chmod +x epoch-agent-darwin-arm64

# Move to a directory in your PATH
sudo mv epoch-agent-darwin-arm64 /usr/local/bin/epoch-agent

5. Verify Installation

epoch-agent --help

Gatekeeper Issues

If you see “epoch-agent cannot be opened because it is from an unidentified developer”:

Option 1: Remove quarantine (recommended)

xattr -d com.apple.quarantine /usr/local/bin/epoch-agent

Option 2: Allow in System Settings

Open System Settings > Privacy & Security
Scroll down to find the blocked app
Click Open Anyway

Installation Directories

The installer tries these locations in order:

~/.local/bin (if exists and writable)
/usr/local/bin (requires sudo)

To specify a custom location:

EPOCH_INSTALL_DIR=/opt/epoch curl -sSL https://epochproxy.cloud/install.sh | bash

Adding to PATH

If the installer warns that the directory is not in your PATH:

# For zsh (~/.zshrc) - default on macOS
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc
source ~/.zshrc

# For bash (~/.bash_profile)
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bash_profile
source ~/.bash_profile

Uninstalling

# If installed to user directory
rm ~/.local/bin/epoch-agent

# If installed system-wide
sudo rm /usr/local/bin/epoch-agent

# Remove state file
rm -rf ~/.config/epoch-agent