Developer Tool

Download Epoch CLI

Manage your agents, authenticate, and connect to remote servers directly from your terminal.

Quickest Way

One-Line Install

Run this command in your terminal to automatically download and install the CLI for your platform.

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

The installer auto-detects your OS and architecture. View install script source or download manually below.

Manual Download

Detecting your platform...

Linux

x86_64 (Intel)

Download

Linux

ARM64 (Apple Silicon / ARM)

Download
Coming Soon

macOS Intel

Available soon

Coming Soon

macOS Apple Silicon

Available soon

Installation

1. Download and install

Download the binary for your platform and place it in your PATH: 

# Download (example for macOS Apple Silicon)
curl -fsSL -o epoch-cli https://epochproxy.cloud/releases/v0.1.0/epoch-cli-darwin-arm64
chmod +x epoch-cli
sudo mv epoch-cli /usr/local/bin/

2. Authenticate

Log in to your Epoch account: 

epoch-cli auth login

3. Start using

List your agents and connect: 

# List all agents
epoch-cli agent list

# Connect to an agent
epoch-cli agent connect <agent-id>

Available Commands

Authentication

  • auth login - Log in to your account
  • auth logout - Log out
  • auth status - Check auth status
  • auth refresh - Refresh credentials

Agent Management

  • agent list - List all agents
  • agent create - Create a new agent
  • agent connect - Connect to an agent
  • agent exec - Execute command on agent

Configuration

  • config show - Show current config
  • config set - Set a config value
  • config get - Get a config value
  • config path - Show config file path

Server

  • server status - Check server status
  • server ping - Ping the server

SSH & Ansible

  • proxy <agent> - SSH ProxyCommand mode
  • inventory - Ansible dynamic inventory
  • inventory --format ini - INI format

Port Forwarding

  • forward -L port:host:port - Local forward
  • forward -R port:host:port - Remote forward

Use epoch-cli --help for full command reference.

Need to install the agent on a server?

The CLI manages agents. To install an agent on a server, visit the agent download page.

Download Agent View Documentation