ZoneKit

A command-line interface for managing DNS zones and records across multiple providers with multi-account support.

Installation • Documentation • Issues • Releases

---

⚠️ Disclaimer

Warning

This is an independent, community-maintained project.

Current Status: Pre-1.0.0 Release (v0.1.0)

This tool is currently in active development and has not reached version 1.0.0. As such:

• ⚠️ Use at your own risk and responsibility
• ⚠️ No warranties or guarantees are provided
• ⚠️ The API may change between versions
• ⚠️ Always test in a sandbox environment first
• ⚠️ Backup your DNS records before making bulk changes
• ⚠️ Review changes carefully before applying them

The maintainers are not responsible for any data loss, service disruption, or other issues that may arise from using this tool. Please report bugs and contribute improvements via GitHub issues and pull requests.

For version information and release notes, see VERSIONING.md.

Features

Feature	Description
Multi-Provider Support	Support for multiple DNS providers (Namecheap, Cloudflare, and more)
Multi-Account Management	Configure and switch between multiple provider accounts
Domain Management	List, check, and manage your domains
DNS Management	Create, update, and delete DNS records
Bulk Operations	Perform multiple DNS operations at once
Account Switching	Easy switching between different accounts
Plugin System	Extensible plugin architecture for custom functionality
Secure Configuration	API keys and credentials stored securely

Quick Start

Click to expand quick start guide

1. Installation

# Clone the repository
git clone https://github.com/SamyRai/zonekit.git
cd namecheap

# Build the binary
make build

# Or build directly
go build -o zonekit ./main.go

2. Configuration

The tool automatically detects configuration files in this priority order:

Priority	Location	Use Case
1	./configs/.zonekit.yaml	Development
2	~/.zonekit.yaml	Production

# Initialize configuration
./zonekit config init

# Or add account interactively
./zonekit account add

3. Test Your Setup

# List accounts
./zonekit account list

# List domains
./zonekit domain list

# Use specific account
./zonekit --account work domain list

For detailed documentation, see the Wiki

Commands

Account Management

Command	Description
account list	List all accounts
account add [name]	Add new account
account switch <name>	Switch to account
account show [name]	Show account details
account edit [name]	Edit account
account remove <name>	Remove account

Domain Management

Command	Description
domain list	List all domains
domain info <domain>	Get domain details
domain check <domain>	Check availability
domain renew <domain> [years]	Renew domain
domain nameservers get <domain>	Get nameservers
domain nameservers set <domain> <ns1> [ns2]...	Set nameservers
domain nameservers default <domain>	Reset to default

DNS Management

Command	Description
dns list <domain>	List DNS records
dns add <domain> <host> <type> <value>	Add DNS record
dns update <domain> <host> <type> <value>	Update DNS record
dns delete <domain> <host> <type>	Delete DNS record
dns clear <domain>	Clear all records
dns bulk <domain> <file>	Bulk operations
dns import <domain> <file>	Import zone file
dns export <domain> [file]	Export zone file

For complete command reference, see Usage Guide

Security

• Configuration files use 600 permissions (owner read/write only)
• API keys are masked in output
• Configuration files are excluded from git by default
• Sensitive data is encrypted in memory

Configuration File Locations

The tool automatically detects configuration files in this priority order:

1. Project Directory (Recommended for development):

   • ./configs/.zonekit.yaml
   • Automatically found when running from project directory

2. Home Directory (Fallback):

   • ~/.zonekit.yaml
   • Used when no project config is found

3. Custom Location:

   • ./zonekit --config /path/to/config.yaml

Pro Tips

Multi-Account Workflow

# 1. Add multiple accounts
./zonekit account add personal
./zonekit account add work
./zonekit account add client1

# 2. Switch between accounts
./zonekit account switch work
./zonekit domain list

./zonekit account switch personal
./zonekit domain list

# 3. Use specific account for one-off commands
./zonekit --account work dns list example.com
./zonekit --account personal domain check newdomain.com

Account Organization

• Use descriptive names: personal, work, client1, client2
• Add descriptions for better organization
• Keep related domains in the same account
• Use sandbox accounts for testing

Troubleshooting

Common Issues

1. "No config file found"

   • Run ./zonekit config init to create a config file
   • Ensure the config file is in the correct location

2. "Account not found"

   • Check available accounts with ./zonekit account list
   • Verify account names are correct

3. API Connection Errors

   • Verify your API key is correct
   • Check that your client IP is correct
   • Ensure you're not using sandbox credentials in production

Getting Help

# Help
./zonekit help

# Command-specific help
./zonekit account --help
./zonekit domain --help
./zonekit dns --help

Migration from Legacy Config

If you have an existing single-account configuration, the tool will automatically migrate it to the new multi-account format. Your existing configuration will be preserved as the default account.

Development

Project Structure

namecheap/
├── cmd/                    # Command implementations
├── pkg/                    # Core packages
│   ├── client/            # Namecheap API client
│   ├── config/            # Configuration management
│   ├── domain/            # Domain operations
│   └── dns/               # DNS operations
├── configs/                # Configuration files
├── internal/               # Internal packages
└── main.go                 # Entry point

Building

# Development build
go build -o zonekit cmd/main.go

# Production build
make build

# Install to system
make install

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

Support

For issues and questions:

• Check the troubleshooting section above
• Review the help command: ./zonekit help
• Open an issue on GitHub