A Lightning Fast CLI for Spaceship
Manage domains, DNS records, contacts, SellerHub listings, and Hyperlift deployments directly from your terminal or AI agent workflows.
Core Advantages
1–3 ms Startup
A single static binary that executes in milliseconds, eliminating VM overhead and heavy runtime bloat.
OS Keystore Security
API keys and secrets are securely held in macOS Keychain, Windows DPAPI, or Linux Secret Service.
Full Platform Parity
Complete coverage of the Spaceship API: domains, personal nameservers, DNS, contacts, sellerhub, and hyperlift.
Agent & Script Friendly
Clean YAML stdout by default, raw JSON via --json, and standardized error envelopes on stderr.
$ spaceship login prod
Enter Spaceship API Key: ak_live_79a8e...
Enter Spaceship API Secret: [hidden]
✓ Successfully authenticated and saved account 'prod'.
$ spaceship domains list -a prod
count: 2
items:
- name: example.com
status: active
autoRenew: true
expirationDate: 2027-05-15T00:00:00Z
$ spaceship dns add --domain example.com --type A --name api --address 198.51.100.42 --ttl 300 -a prod
status: ok
domain: example.com
type: A
name: api
address: 198.51.100.42
When To Use Spaceship CLI
Guidance for engineers, automated pipelines, and autonomous AI agents.
Best-Fit Scenarios
- Automated DNS & Record Management: Programmatically create, inspect, update, and prune DNS records for web services, email verification, and SSL certificates.
- Autonomous AI Agents: Drive domain registrations, transfer tracking, and DNS configurations deterministically using
--jsonmode, structured error envelopes, andspaceship agent-readme. - Multi-Account Workspaces: Seamlessly isolate production, staging, and client domains across multiple Spaceship accounts without secret leakage.
- Hyperlift CI/CD Deployments: Trigger web application deployments and configure environment variables directly from build scripts.
When Not to Use
- When you need visual drag-and-drop dashboard controls (use spaceship.com).
- When managing domains hosted on other registrars (Spaceship CLI targets the Spaceship public API exclusively).
Quickstart Workflow
Get up and running in less than two minutes.
Install
Install the CLI using Cargo or download prebuilt binaries from the GitHub releases page.
Authenticate
Run spaceship login to input your Spaceship API Key and Secret, securely stored in your OS keystore.
Manage & Automate
Query domains, update DNS records, check operations, and deploy web applications with safety guardrails.
v1.0.0 Stable Release
Download pre-compiled standalone binaries for macOS, Linux, and Windows.
View full changelog and SHA256 checksums on GitHub Releases.
Command Reference
Organized by resource category.
# Interactive login with prompts for API Key & Secret (saves as 'default') spaceship login # Log in under a named account alias spaceship login work # Scripted login via stdin (no echo or shell history) printf "%s\n%s\n" "$KEY" "$SECRET" | spaceship login ci --api-key-stdin # List configured accounts and test live API credentials spaceship accounts list --check spaceship accounts test work # Remove an account from this machine spaceship accounts remove work --yes
# Check domain availability and pricing spaceship domains check --domains "example.com,example.org" -a default # List registered domains in your account spaceship domains list -a default # Get detailed configuration for a specific domain spaceship domains get --domain example.com -a default # List all DNS records for a domain spaceship dns list --domain example.com -a default # Add an A record spaceship dns add --domain example.com --type A --name api --address 198.51.100.42 --ttl 300 -a default # Delete a specific DNS record spaceship dns delete --domain example.com --type A --name api --address 198.51.100.42 -a default
# List configured contact profiles spaceship contacts list -a default # Create a new contact profile spaceship contacts create --first-name Jane --last-name Doe --email jane@example.com \ --address1 "123 Main St" --city Seattle --state WA --country US --postal-code 98101 \ --phone "+1.2065550123" -a default # Enable WHOIS privacy protection on a domain spaceship domains privacy --domain example.com --privacy-protection true -a default # Toggle registrar transfer lock spaceship domains lock --domain example.com --is-locked true -a default
# List marketplace listings in SellerHub spaceship sellerhub listings -a default # Submit domain verification via SafePay spaceship sellerhub safepay --domain example.com --token "safepay-verification-token" -a default # List Hyperlift web service deployments spaceship hyperlift deployments -a default # Set environment variable for Hyperlift deployment spaceship hyperlift env-set --name DATABASE_URL --value "postgres://..." -a default # Check asynchronous background operation status spaceship operations get --operation-id "op_987654321" -a default