conway-terminal
v2.0.9
Published
Terminal for AGI — compute, wallet, payments, deployment via MCP
Maintainers
Readme
Conway Terminal
The terminal for AGI. Compute, wallet, payments, deployment -- one install gives any AI agent write access to the real world.
To exist, you must pay for your compute.
Conway Terminal is an MCP server + CLI for AI agents. It gives one install access to:
- Conway Cloud (Linux VMs)
- Conway Compute (inference)
- Conway Domains (registration + DNS)
- Wallet + x402 payments across all products
Quick Start
1) Install and initialize
Use npx (one-off run):
npx -y conway-terminal --initOr install globally with npm:
npm install -g conway-terminal
conway-terminal --initOr install via script:
curl -fsSL https://conway.tech/terminal.sh | sh2) Fund your creator wallet
On first run, Conway Terminal creates:
- Wallet:
~/.conway/wallet.json - Config:
~/.conway/config.json
This wallet is the creator wallet used for x402 payments. Fund that address with USDC:
eip155:8453(Base mainnet) for productioneip155:84532(Base Sepolia) for testing
Use wallet_info to get the wallet address and balances.
3) Add to your MCP client
Use this MCP server entry:
{
"mcpServers": {
"conway": {
"command": "conway-terminal"
}
}
}4) Run a quick smoke flow
wallet_infoto verify fundingsandbox_createto start a VMsandbox_execto run a commandsandbox_terminal_sessionto open a browser terminal
Conway Product Map
Conway Terminal is the control layer for three product surfaces:
- Conway Cloud (docs)
Linux sandboxes, command execution, file operations, web terminal, PTY sessions, and port exposure.
Primary tools:
sandbox_*,sandbox_pty_*,credits_*. - Conway Compute (docs)
Inference API for frontier models with credit-based billing.
Primary tool:
chat_completions. - Conway Domains (docs)
Domain search, registration, renewals, and full DNS management.
Primary tools:
domain_*.
Tools
Sandboxes (Conway Cloud Linux VMs)
Full Linux virtual machines on Firecracker microVMs. Ubuntu 22.04, isolated kernel, auto-SSL on exposed ports. Docs: https://docs.conway.tech/cloud
| Tool | Description |
|------|-------------|
| sandbox_create | Create a VM (1–4 vCPU, 512–8192 MB RAM, 1–50 GB disk). Regions: eu-north, us-east |
| sandbox_list | List all active sandboxes with status, resources, and region |
| sandbox_get | Get full details for a sandbox by ID |
| sandbox_delete | Destroy a sandbox and release resources |
| sandbox_exec | Run a shell command and get stdout, stderr, exit code |
| sandbox_write_file | Upload a file (text or base64 binary, up to 10 MB) |
| sandbox_read_file | Read a file from a sandbox |
| sandbox_expose_port | Expose a port to the internet with auto-SSL. Optional custom subdomain |
| sandbox_list_ports | List all exposed ports for a sandbox |
| sandbox_remove_port | Unexpose a port and clean up any subdomain |
| sandbox_get_url | Get the public URL for a port: https://{port}-{id}.life.conway.tech |
| sandbox_terminal_session | Get a browser-accessible terminal URL (30-day sliding session) |
| sandbox_metrics | Live CPU and memory usage |
| sandbox_activity | API activity log for a sandbox |
| sandbox_commands | Command execution history |
Interactive Terminal (PTY)
Persistent pseudo-terminal sessions for interactive programs — REPLs, editors, long-running processes. Docs: https://docs.conway.tech/cloud/pty
| Tool | Description |
|------|-------------|
| sandbox_pty_create | Start a PTY session (bash, python3, node, etc.) |
| sandbox_pty_write | Send input to the session. Use \n for Enter |
| sandbox_pty_read | Read current terminal screen output |
| sandbox_pty_close | End the session and terminate the process |
| sandbox_pty_resize | Resize terminal dimensions (cols × rows) |
| sandbox_pty_list | List all active PTY sessions for a sandbox |
Wallet & x402 Payments
Local EVM wallet for permissionless payments. Automatically created at ~/.conway/wallet.json on first run. Supports multiple chains (currently Base mainnet and Base Sepolia). No login, no KYC, no human approval.
| Tool | Description |
|------|-------------|
| wallet_info | Wallet address and USDC balance for a selected network (eip155:8453 or eip155:84532) |
| wallet_networks | Supported chains and USDC contract addresses |
| x402_discover | Discover x402-enabled endpoints from a domain |
| x402_check | Check if a URL requires x402 payment |
| x402_fetch | Fetch a URL with automatic payment — signs EIP-3009 USDC transfer on 402 |
Domains
Register, renew, and manage domains with full DNS control. Paid with USDC via x402. Docs: https://docs.conway.tech/domains
| Tool | Description |
|------|-------------|
| domain_search | Search available domains across TLDs with pricing |
| domain_list | List all registered domains |
| domain_info | Get domain status, expiry, nameservers, privacy settings |
| domain_register | Register a domain — automatic x402 USDC payment |
| domain_renew | Renew a domain — automatic x402 USDC payment |
| domain_dns_list | List DNS records for a domain |
| domain_dns_add | Add a DNS record (A, AAAA, CNAME, MX, TXT, SRV, CAA, NS) |
| domain_dns_update | Update an existing DNS record |
| domain_dns_delete | Delete a DNS record |
| domain_pricing | Get registration/renewal pricing per TLD |
| domain_check | Check exact domains and return registration pricing |
| domain_privacy | Enable or disable WHOIS privacy |
| domain_nameservers | Update custom nameservers |
Credits
Prepaid credits for Conway services. The same credit balance can be used for both Conway Cloud (VMs) and Conway Compute (inference). Fund via x402 or at app.conway.tech. Docs: https://docs.conway.tech/cloud and https://docs.conway.tech/compute
| Tool | Description |
|------|-------------|
| credits_balance | Current credit balance |
| credits_history | Transaction history (top-ups, charges) |
| credits_pricing | VM pricing tiers and payment amounts |
| credits_topup | Pay an x402 tier from the local wallet to top up Conway credits |
| credits_purchase | Alias of credits_topup |
Inference
Access OpenAI models billed from Conway credits. Docs: https://docs.conway.tech/compute/inference
| Tool | Description |
|------|-------------|
| chat_completions | Chat completion via OpenAI models (gpt-4o, gpt-4o-mini, o3-mini, etc.) |
Links
MIT
