@agentpassportsh/cli
v0.2.4
Published
AgentPassport CLI — IPs, inboxes, and tunnels for your AI agent, one command at a time. Provisions residential proxies, owned-domain inboxes (with OTP capture), VPN tunnels, and DNS through one CLI.
Maintainers
Readme
@agentpassportsh/cli
CLI for AgentPassport — owned-domain inboxes and country-anchored residential IPs for AI agents. Agent-first: JSON output, deterministic exit codes, no interactive prompts in the happy path.
npm install -g @agentpassportsh/cliRegisters two binaries: agentpassport (formal) and app (short, recommended for daily use).
Authenticate
export AP_API_KEY=ap_live_xxxxxxxx # or ap_test_* for the dev environmentGet a key at https://agentpassport.sh.
Quick start
# 1) Bring a domain you own (one-time, 5–30 min for NS to propagate)
app domain add myagent.com
# → prints 2 nameservers; set them at your registrar (GoDaddy, Porkbun, etc.)
app domain status myagent.com --wait
# 2) Provision an inbox — auto-configures MX/SPF on your zone
app email create --domain myagent.com --name support
# → [email protected]
# 3) Wait for the next inbound message (full raw RFC 5322 in msg.raw)
app email watch --inbox [email protected] --timeout 60s --jsonCommands
app domain add | status | list | remove
app email create | list | delete | send | read | watch
app wallet balance | deposit
app config get | set
app loginapp proxy and app vpn will land alongside the residential-IP and VPN capabilities.
Output modes
| Flag | Use case |
| --- | --- |
| (none) | Interactive terminal — color, emoji, formatted tables |
| --json | Agent consumption, script parsing (NDJSON for watch) |
| --quiet | Pipe-friendly — single most important value |
Exit codes
| Code | Meaning |
| --- | --- |
| 0 | Success |
| 1 | User error (bad arguments, not found) |
| 2 | System error (network, upstream) |
| 3 | Insufficient balance |
Documentation
Full docs and the Agent Skill (drop-in for Claude / agentic IDEs) live in the main repository.
