Product Updates
Introducing OSIR CLI: Manage Your Entire Domain Infrastructure From the Terminal
2026-03-06 · Name.al Team
The Terminal Is Your New Control Panel
We are excited to announce OSIR CLI — a powerful command-line interface that brings the full OSIR platform to your terminal. Whether you are a sysadmin automating DNS changes across dozens of domains, a DevOps engineer wiring deployments into CI/CD, or a developer who simply prefers the keyboard over the browser, OSIR CLI was built for you.
One binary. Zero dependencies. Download it, authenticate, and start managing your infrastructure in seconds.
What Can OSIR CLI Do?
OSIR CLI ships with 76 commands organized into 11 command groups:
- Domain Management — Check availability, register, renew, lock/unlock, set privacy protection, update nameservers, validate
- DNS Records — Full CRUD for A, AAAA, CNAME, MX, TXT, and SRV records, plus zone management and DNSSEC
- VPS Management — Create, start, stop, restart, resize, delete, and monitor virtual servers
- Billing & Payments — Check balance, view invoices, make payments, see transaction history, pricing, checkout
- Domain Suggestions — AI-powered name generation, word spinning, prefix/suffix variations, bulk suggestions
- Contact Management — Create and manage registrant contact profiles
- Audit Logs — Review domain and account activity trails
- Account — Profile and account summary dashboard
- Product Catalog — Browse domain extensions and server configurations
- Interactive Shell — A Junos-style REPL with tab completion and persistent history
Every command supports a -o json flag, making OSIR CLI a perfect building block for scripts, cron jobs, and CI/CD pipelines.
Getting Started in 60 Seconds
Download the binary for your platform, make it executable, and authenticate:
# Download (Linux example)
curl -L -o osir https://github.com/Osir-Inc/cli/releases/download/v1.0.1/osir-linux-x86_64
chmod +x osir
sudo mv osir /usr/local/bin/
# Authenticate
osir auth login --device
# Opens a URL — log in from any browser, even on a different device
# You're ready
osir domain check mybrand.com
OSIR CLI supports Linux, macOS, and Windows on both x86-64 and ARM64 architectures.
Interactive Shell: A CLI Within the CLI
Run osir shell to enter an interactive session inspired by network switch CLIs like Junos and Arista EOS. You get:
- Tab completion — Context-aware suggestions for commands, subcommands, and flags
?key help — Press?at any point to see available completions- Persistent history — Commands saved across sessions with
Ctrl+Rreverse search - Session reuse — Authenticate once, run as many commands as you want
osir> domain check coolstartup.io
Domain: coolstartup.io
[OK] Available
osir> domain register coolstartup.io --years 2 --privacy --auto-renew
[OK] Domain registered: coolstartup.io
osir> dns create coolstartup.io A @ 192.0.2.1
[OK] DNS record created (ID: coolstartup_io__A_123456)
Built for Automation
Scripting with JSON Output
Pipe JSON output into jq for powerful one-liners:
# List all domains expiring before June
osir -o json domain list | \
jq -r '.domains[] | select(.expirationDate < "2026-06-01") | .domain'
# Batch-check a list of domains
for domain in startup.com startup.io startup.net; do
available=$(osir -o json domain check "$domain" | jq -r '.available')
echo "$domain: $available"
done
CI/CD Integration
Add OSIR CLI to your deployment pipeline to update DNS records automatically:
# GitHub Actions example
- name: Install OSIR CLI
run: |
curl -L -o osir https://github.com/Osir-Inc/cli/releases/download/v1.0.1/osir-linux-x86_64
chmod +x osir && sudo mv osir /usr/local/bin/
- name: Update DNS for deployment
run: |
osir dns create myapp.com A @ ${{ env.SERVER_IP }} --ttl 300
Cron Jobs
Schedule recurring tasks like balance monitoring or expiration alerts:
# Daily balance check at 9 AM
0 9 * * * /usr/local/bin/osir -o json billing balance >> /var/log/osir-balance.log
# Weekly expiring domain alert
0 8 * * 1 /usr/local/bin/osir -o json domain list | \
jq -r '.domains[] | select(.expirationDate < "2026-06-01") | .domain' | \
mail -s "Expiring domains" admin@company.com
OAuth Device Flow: Headless-Friendly Authentication
OSIR CLI uses an OAuth 2.0 Device Flow that works perfectly on servers without a browser. Run osir auth login --device, and it gives you a URL and code. Open that URL on any device — your phone, your laptop — enter the code, and the CLI is authenticated. Tokens are stored securely at ~/.osir/credentials.json with proper file permissions and are automatically refreshed when needed.
Grab the binary, give it a spin, and let us know what you build with it. Visit the AI Integration page for setup instructions, or check the Developer Docs for the full command reference.