indietool

Tired of bouncing between registrars, tracking domain renewals in spreadsheets, and copy-pasting secrets into .env files?

🎯 indietool is a CLI tool for indie builders that helps you

• 🌍 Hunt domain names across 50+ TLDs — in seconds
• 🗓️ Track expiries across registrars like Cloudflare & Porkbun
• ☁️ Manage DNS records across providers with auto-detection
• 🔐 Securely store API keys & secrets using your OS keyring

No dashboards. No vendor lock-in. Just you and your terminal.

---

🚀 Quick Start

Installation

# macOS/Linux (recommended)
go install github.com/indietool/cli@latest

Try it in 30 seconds

# Check domain availability
indietool domain explore myapp

# Save a test API key (auto-creates encryption key)
indietool secret set stripe-key "sk_test_..." --note "Stripe test key"

# Manage DNS records with automatic provider detection
indietool dns list example.com

---

🔁 Everyday Developer Flows

Weekend Project Setup

# Check which domains are available
indietool domain explore myproject --tlds dev,com,ai

# Set up DNS records for your new domain
indietool dns set myproject.dev @ A 192.168.1.100
indietool dns set myproject.dev www CNAME myproject.dev
indietool dns set myproject.dev api A 192.168.1.101

# Store your API keys securely (auto-creates encryption key)
indietool secret set openai-key "sk-..." --note "OpenAI API key"
indietool secret set stripe-key "sk_test_..." --note "Stripe test key"

# Organize secrets by project using custom databases
indietool secret set api-key@myproject "key123" --note "Project-specific key"

Production Deployment

# Check domain expiry before renewal
indietool domains list --provider cloudflare

# Verify DNS configuration before going live
indietool dns list myproject.com --wide

# Clean up old DNS records
indietool dns delete myproject.com old-api A

# Update production DNS records
indietool dns set myproject.com @ A 203.0.113.10
indietool dns set myproject.com www CNAME myproject.com

# Export secrets for deployment
export OPENAI_KEY=$(indietool secret get openai-key -S)

---

💡 Features

---

🔍 Find Available Domains Instantly

Problem: Manually checking domain names is slow and painful. Solution: indietool domain explore checks 50+ TLDs in seconds.

indietool domain explore awesomeproject

DOMAIN                     STATUS     TLD         EXPIRY
awesomeproject.ai          Available  ai          -
awesomeproject.dev         Available  dev         -
awesomeproject.com         Taken      com         2026-07-06
...
50 domains checked: 45 available, 5 taken

Filter by specific TLDs:

indietool domain explore awesomeproject --tlds ai,dev,io,sh

Or pass a TLD list from file:

indietool domain explore myproject --tlds @tldfile

---

🔎 Direct Domain Lookup

Know the exact domain you're targeting?

indietool domain search awesomeproject.io

---

📊 Track All Your Domains in One Place

Problem: Domains expire. You don’t want surprises. Solution: View all domains across registrars in one simple table.

First, connect your registrar(s):

# Cloudflare
indietool config add provider cloudflare \
  --account-id YOUR_ACCOUNT_ID \
  --api-token YOUR_TOKEN \
  --email your@email.com

# Porkbun
indietool config add provider porkbun \
  --api-key YOUR_KEY \
  --api-secret YOUR_SECRET

Then list your domains:

indietool domains list

NAME                PROVIDER    STATUS   EXPIRES  AUTO-RENEW  AGE
myawesomeapp.com    cloudflare  healthy  8mo      Yes         2y
sideproject.ai      cloudflare  healthy  1y       Yes         1y

Need more info?

indietool domains list --wide

NAME                PROVIDER    STATUS   EXPIRES  AUTO-RENEW  AGE   NAMESERVERS                          COST  UPDATED
myawesomeapp.com    cloudflare  healthy  8mo      Yes         2y    fred.ns.cloudflare.com,pam.ns.cl...  N/A   2y
sideproject.ai      cloudflare  healthy  1y       Yes         1y    fred.ns.cloudflare.com,pam.ns.cl...  N/A   1y

---

☁️ Manage DNS Records Across Providers

Problem: Managing DNS records across different providers is tedious and error-prone. Solution: indietool dns automatically detects your DNS provider and lets you list and update records from the command line.

List DNS records

# Auto-detect provider and list records
indietool dns list example.com

TYPE  NAME     CONTENT
A     ☁️@      192.168.1.1
A     www      192.168.1.2
CNAME ☁️api    example.com
MX    @        10 mail.example.com

Note: ☁️ indicates Cloudflare proxied records, available only with the Cloudflare provider, for domains hosted on Cloudflare

Get detailed view

indietool dns list example.com --wide

TYPE  NAME     CONTENT          TTL   PRIORITY  ID
A     ☁️@      192.168.1.1      300             abc123
A     www      192.168.1.2      300             def456
CNAME ☁️api    example.com      300             ghi789
MX    @        mail.example.com 300   10        jkl012

Set DNS records

# Add an A record
indietool dns set example.com www A 192.168.1.100

# Add MX record with priority
indietool dns set example.com @ MX "10 mail.example.com" --priority 10

# Add TXT record for domain verification
indietool dns set example.com @ TXT "v=spf1 include:_spf.google.com ~all"

Delete DNS records

# Delete specific record by name and type
indietool dns delete example.com www A

# Delete all records for a name (with confirmation)
indietool dns delete example.com api

# Delete specific record by ID (when multiple records have same name)
indietool dns delete example.com test --id abc123

# Delete without confirmation
indietool dns delete example.com www A --force

# Delete root domain record
indietool dns delete example.com @ MX

# Combine filters for precision
indietool dns delete example.com api --type CNAME --id def456

Specify provider explicitly

# Use specific provider instead of auto-detection
indietool dns list example.com --provider cloudflare
indietool dns set example.com api A 192.168.1.50 --provider porkbun
indietool dns delete example.com old-record A --provider namecheap

Supported DNS providers

• ✅ Cloudflare - Full CRUD operations with proxy status indicators
• ✅ Porkbun - Complete DNS record management (list, set, delete)
• ✅ Namecheap - Full CRUD support with batch operations

Auto-detection

indietool automatically detects your DNS provider by checking nameservers:

• No need to specify --provider in most cases
• Seamlessly works across different providers
• Falls back to manual provider selection if needed

---

🔐 Secure Local Secrets Without the Hassle

Problem: Secrets are either insecure or annoying to manage. Solution: indietool secrets encrypts secrets using your OS keyring — no cloud, no sync, no complicated setup to manage.

How it works

Component	Stored At	Encrypted
Secrets Database	~/.config/indietool/secrets/	✅
Encryption Key	OS Keyring (Keychain, gnome-keyring)	✅

Store a secret (auto-initializes encryption)

No setup required! The first time you store a secret, indietool automatically creates an encryption key.

indietool secret set stripe-key "sk_test_..." --note "Stripe test key"
✓ Auto-generated encryption key for database 'default'
✓ Secret 'stripe-key' stored successfully

Organize secrets with custom databases

Use the key@database format to organize secrets by project or environment:

# Store in custom databases
indietool secret set api-key@production "prod_key_123"
indietool secret set api-key@staging "staging_key_456"
indietool secret set db-password@myproject "secret123"

# Retrieve from specific database
indietool secret get api-key@production -S

Retrieve a secret

# Safe output (masked)
indietool secret get stripe-key

# Show actual value (use -S or --show)
indietool secret get stripe-key -S

List all secrets

# List secrets in default database
indietool secret list

# List secrets in specific database
indietool secret list @production
indietool secret list @staging

Manage databases

List all your secret databases:

indietool secrets db list

Available secrets databases:
  default (default)
  production
  staging
  myproject

Delete a database and all its secrets:

# Interactive confirmation
indietool secrets db delete staging

# Force delete without confirmation
indietool secrets db delete staging --force

Use in environment variable

export STRIPE_KEY=$(indietool secret get stripe-key -S)

---

🧠 FAQ

❓ Which providers are supported?

Provider	Domains	DNS	Secrets
Cloudflare	✅	✅	❌
Porkbun	✅	✅	❌
Namecheap	✅	✅	❌
GoDaddy	✅	❌	❌
Local	❌	❌	✅

Legend:

• ✅ Full support
• 🚧 In development
• ❌ Not supported

Notes:

• Domains: Domain registration management, expiry tracking, nameserver updates
• DNS: DNS record management (list, create, update, delete) with ID-based targeting
• Secrets: Local encrypted secret storage using OS keyring

---

❓ Where are my secrets stored?

Encrypted locally at ~/.config/indietool/secrets/, using an encryption key stored in your OS keyring.

---

❓ What if I lose my computer?

Secrets are useless without your OS user account + keyring. Just start storing secrets on your new machine - no manual initialization needed.

---

❓ Does it work on Windows?

Not yet — currently macOS and Linux only. Windows support is planned.

---

🧯 Troubleshooting

Secrets aren't saving?

• Ensure your keyring (Keychain or gnome-keyring) is unlocked
• Check file permissions on ~/.config/indietool/secrets/

"Permission denied" errors?

• Check file permissions on ~/.config/indietool
• Ensure your user has write access to the config directory

API key errors with registrars?

• Double check key/secret pair
• Some registrars require IP allowlisting or scopes

---

🚫 Limitations

• ❌ No Windows support (yet)
• 🧩 Only supports a few registrars (Cloudflare, Porkbun, Namecheap, Godaddy)
• ☁️ DNS management: GoDaddy implementation in progress
• 💻 CLI only — no web UI or GUI planned
• 🔄 Secrets not synced across machines (by design)

---

❤️ Built for indie builders who just want to ship

Stop wasting time in control panels and spreadsheets. Let indietool handle the busywork — so you can focus on building.

Get Started →