Documentation

1. Create an account

Sign up at aitaohoo.com/register. All new accounts include a 14-day Pro trial with full access to all features.

2. Install the CLI

curl -fsSL https://storage.googleapis.com/aitaohoo-releases/cli/latest/aitaohoo-linux-amd64 -o aitaohoo
chmod +x aitaohoo
sudo mv aitaohoo /usr/local/bin/

3. Authenticate

aitaohoo auth login
# Enter your API key from the dashboard Settings page

4. Start a tunnel

# Expose a local web server on port 3000
aitaohoo tunnel http 3000

# With a custom subdomain (Pro tier)
aitaohoo tunnel http 3000 --subdomain myapp

Supported Platforms

AITaoHoo CLI is available for Linux (x86_64, ARM64), macOS (Intel, Apple Silicon), and Windows (x86_64). Pre-built binaries are available on the download page.

Download & Install

# x86_64
curl -fsSL https://storage.googleapis.com/aitaohoo-releases/cli/latest/aitaohoo-linux-amd64 -o aitaohoo
chmod +x aitaohoo
sudo mv aitaohoo /usr/local/bin/

# ARM64
curl -fsSL https://storage.googleapis.com/aitaohoo-releases/cli/latest/aitaohoo-linux-arm64 -o aitaohoo
chmod +x aitaohoo
sudo mv aitaohoo /usr/local/bin/

Security Warning

Since AITaoHoo is not distributed through the Mac App Store, macOS will show a warning: "Apple could not verify AITaoHoo is free of malware." This is normal for apps downloaded outside the App Store.

Method 1: Right-click (Recommended)

Right-click (or Control+click) on AITaoHoo.app, select "Open" from the context menu, then click "Open" in the dialog that appears. You only need to do this once.

Method 2: Terminal Command

# Remove the quarantine attribute
xattr -cr /Applications/AITaoHoo.app

# Then open the app normally

API Keys

API keys are used to authenticate the CLI with the AITaoHoo server. You can create and manage API keys from the Settings page in the dashboard. Each key has a "moji_" prefix for identification.

Login with CLI

# Interactive login
aitaohoo auth login

# Login with API key directly
aitaohoo auth login --key moji_your_api_key_here

Check auth status

aitaohoo auth status

HTTP Tunnels

HTTP tunnels expose a local web server through a public URL with automatic SSL termination. This is the most common tunnel type.

# Basic HTTP tunnel
aitaohoo tunnel http 3000

# With custom subdomain
aitaohoo tunnel http 3000 --subdomain myapp
# Access at: https://myapp.gateway.aitaohoo.com

TCP Tunnels (Pro+)

TCP tunnels forward raw TCP traffic, useful for databases, game servers, SSH, or any non-HTTP protocol.

# TCP tunnel for a database
aitaohoo tunnel tcp 5432

# TCP tunnel for SSH
aitaohoo tunnel tcp 22

Managing Tunnels

Active tunnels are displayed in the dashboard under the Tunnels page. You can monitor real-time traffic, see connection counts, and close tunnels from the web UI or by pressing Ctrl+C in the terminal.

How Subdomains Work

Every tunnel gets a subdomain under gateway.aitaohoo.com. Free tier users get random subdomains (e.g. swift-fox-123). Pro and Enterprise users can reserve custom subdomains.

Reserving a Subdomain

Reserve subdomains from the dashboard Subdomains page. Reserved subdomains are permanently linked to your account and can be used across tunnel sessions.

Using a Reserved Subdomain

aitaohoo tunnel http 3000 --subdomain myapp
# Always accessible at: https://myapp.gateway.aitaohoo.com

Dashboard Analytics

The Analytics page shows real-time and historical data for all your tunnels including total requests, bandwidth usage, average response time, and status code breakdown.

Metrics Available

Requests per minute, total bandwidth (upload/download), response time percentiles, HTTP status code distribution, geographic distribution of clients, and top paths by request count.