Uplink CLI

Agent based web management — share localhost, host apps, and attach domains from the terminal. Built for Cursor, Claude Code, Codex, Windsurf, and humans who live in a shell.

Key features

• Share any local port: localhost:<port> → public HTTPS (https://abc123.x.uplink.spot)
• Agent-first: --json, stable exit codes, --token-stdin (no browser required)
• Hosting: deploy Next.js / Vite / static apps to Uplink
• Domain hub: one inventory for domains scattered across GoDaddy, Cloudflare, Hostinger, Namecheap, DreamHost — and any cPanel host (Namecheap shared, Bluehost, HostGator, …)
• Custom hostnames: attach a domain you own to a hosted app and verify DNS
• Interactive menu: uplink for humans; CLI subcommands for agents

Learn more at uplink.spot

Install

npm install -g uplink-cli
# or
npx uplink-cli --help

Changelog: CHANGELOG.md. Product: docs/PRODUCT.md. Hosting: docs/HOSTING.md.

Start without signup

# Guest token is created and saved automatically
uplink tunnel create --port 3000 --json

Guest access includes one active tunnel for 24 hours and public domain search.

Unlock persistent features

uplink login --email [email protected]
uplink login --email [email protected] --code 123456 --json

Email verification preserves the guest tunnel and unlocks hosting, databases, and registrar features. Aliases and custom domains still depend on the account plan.

Quick start (agents)

# Creates guest access automatically when needed
uplink tunnel create --port 3000 --json

# List / stop
echo "$AGENTCLOUD_TOKEN" | uplink --token-stdin tunnel list --json
echo "$AGENTCLOUD_TOKEN" | uplink --token-stdin tunnel stop --id tun_xxx --json

Full contract: AGENTS.md (also at docs/AGENTS.md).

Quick start (interactive)

uplink        # open menu

• Sharing → Share localhost → pick port → public URL
• Domains → connect registrar, attach hostname to a hosted app
• Hosting → Setup / Deploy / List / Delete

Hosting (non-interactive)

echo "$AGENTCLOUD_TOKEN" | uplink --token-stdin host setup \
  --path . --name myapp --yes --json

Domains (non-interactive)

uplink domains providers connect godaddy --token-env GODADDY_PAT --json
uplink domains providers connect cpanel --host server341.web-hosting.com \
  --user-env CPANEL_USER --token-env CPANEL_API_TOKEN --json
uplink domains list --json
echo "$AGENTCLOUD_TOKEN" | uplink --token-stdin \
  host domains add --id app_xxx --hostname example.com --json

Agent essentials

• --json: stdout = JSON only; stderr = logs/errors
• --token-stdin: read token once from stdin (avoid argv leaks)
• --api-base: override API host if needed
• Exit codes: 0 ok · 2 usage · 10 auth · 20 network · 30 server/unknown

Key commands

• uplink menu — interactive UI
• uplink login --email <email> [--code <code>] [--json]
• uplink signup --json
• uplink tunnel create --port <p> [--alias <a>] [--json] — starts client
• uplink tunnel list|stats|stop|alias-set|alias-delete --json
• uplink host setup|deploy|list|status|logs|delete …
• uplink host domains add|verify|list|remove …
• uplink domains list|check|providers …

Environment

export AGENTCLOUD_TOKEN=your-token
export AGENTCLOUD_API_BASE=https://api.uplink.spot
export TUNNEL_CTRL=tunnel.uplink.spot:7443
export TUNNEL_DOMAIN=x.uplink.spot

Troubleshooting

• URL not live — ensure something is listening on the port and the client started (tunnel list → connected)
• Auth errors — verify AGENTCLOUD_TOKEN or ~/.uplink/credentials; prefer --token-stdin for agents
• Relay errors — TUNNEL_CTRL=tunnel.uplink.spot:7443 (TLS)
• Domain search — uplink domains or uplink domains search acme --json (public DNS/RDAP)

Docs

• Agents: AGENTS.md
• Product: docs/PRODUCT.md
• Hosting: docs/HOSTING.md
• Menu: docs/MENU_STRUCTURE.md
• Changelog: CHANGELOG.md

License

MIT — see LICENSE