Skip to content

improvmx/cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ImprovMX CLI

Manage your ImprovMX email forwarding directly from the terminal. Add domains, create aliases, manage SMTP credentials, view logs, and more. Perfect for interacting with ImprovMX from Claude Code, OpenAI Codex, or OpenClaw!

Installation

From source

Requires Go 1.21+.

go install github.com/improvmx/cli@latest

From release binaries

Download the latest binary for your platform from Releases.

Authentication

Get your API key from your ImprovMX dashboard, then:

improvmx auth login

Or set the environment variable:

export IMPROVMX_API_KEY=your-api-key

Usage

Domains

improvmx domain list                  # List all domains
improvmx domain add example.com       # Add a domain
improvmx domain get example.com       # Get domain details
improvmx domain check example.com     # Check DNS configuration
improvmx domain delete example.com    # Delete a domain

Aliases

improvmx alias list example.com                       # List aliases
improvmx alias add example.com hello user@gmail.com   # Add an alias
improvmx alias add example.com "*" user@gmail.com     # Add a catch-all
improvmx alias update example.com hello new@gmail.com # Update an alias
improvmx alias delete example.com hello               # Delete an alias

Email Logs

improvmx logs example.com             # View recent email logs

Rules

improvmx rule list example.com                                                                        # List rules
improvmx rule get example.com <rule-id>                                                               # Get rule details
improvmx rule add example.com --type alias --alias hello --forward user@gmail.com                     # Add alias rule
improvmx rule add example.com --type regex --regex ".*invoice.*" --scopes subject,body --forward user@gmail.com  # Add regex rule
improvmx rule add example.com --type cel --expression "subject.contains('finance')" --forward user@gmail.com     # Add CEL rule
improvmx rule update example.com <rule-id> --forward new@gmail.com                                    # Update a rule
improvmx rule delete example.com <rule-id>                                                            # Delete a rule
improvmx rule delete-all example.com                                                                  # Delete all rules

SMTP Credentials

improvmx smtp list example.com                    # List credentials
improvmx smtp add example.com user password        # Add credentials
improvmx smtp delete example.com user              # Delete credentials

Account

improvmx account                       # View account info

Options

Flag Description
--json Output in JSON format
--help Show help for any command

JSON output

Every command supports --json for scripting and piping:

improvmx domain list --json | jq '.domains[].domain'

Shell completions

# Bash
improvmx completion bash > /etc/bash_completion.d/improvmx

# Zsh
improvmx completion zsh > "${fpath[1]}/_improvmx"

# Fish
improvmx completion fish > ~/.config/fish/completions/improvmx.fish

Configuration

Credentials are stored at:

  • macOS: ~/Library/Application Support/improvmx/config.yaml
  • Linux: ~/.config/improvmx/config.yaml

License

MIT

About

ImprovMX CLI - Manage email forwarding from the terminal, perfect for Claude Code

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages