domani

domani

人間とAIエージェントのための、ドメインとメール。

ドメインの登録、DNS の管理、メールボックスの作成、メールの送受信ができます。ターミナル、エージェント、またはウェブから利用できます。

仕組み

domani では、1 つのアカウントに複数の方法でアクセスできます。

• Web - 受信トレイ（作成、返信、スレッド表示）、DNS エディター、ドメイン管理を備えたダッシュボード
• CLI - このパッケージです。ウェブアプリでできることをすべてターミナルから実行できます
• MCP Server - Claude Code、Cursor、Codex、および MCP 互換のあらゆるエージェント向けの型付きツール
• OpenClaw - openclaw skills install @gwendall/domani
• Agent Skill - エージェントが従える手順ガイドです。npx skills add domani.run でインストールできます
• REST API - あらゆる機能に HTTP で直接アクセスできます

すべてのインターフェースで、同じ API キーと同じデータを共有します。

インストール

npm install -g domani-cli

セキュアな MCP ブリッジ

エージェントプラグインは、プロンプト、シェルの履歴、エディターの設定に API キーを記載することなく、Domani を利用できます。

domani login --surface mcp
domani mcp serve

domani login は、利用可能な場合、認証情報をオペレーティングシステムのキーチェーンに保存します。stdio ブリッジは認証情報をローカルで取得し、MCP リクエストを https://domani.run/mcp に転送します。標準出力は JSON-RPC メッセージ専用です。 保存済みアカウントが複数ある場合、ブリッジを DOMANI_ACCOUNT=<name> domani mcp serve（または domani --account <name> mcp serve）で起動すると、使用するアカウントを指定できます。

他の人に代わって操作するエージェントには、その人のアカウントキーではなく、スコープを限定した有効期限付きの認証情報をリクエストしてください。

domani login --scopes domains:read,search --label "Project agent" --expires-in 86400

承認画面には要求されたアクセス権が表示され、発行された認証情報は出力されずにキーチェーンへ保存されます。

ログイン後、ほかのツールを確認したりドメインを購入したりする前に、受信から返信までの一連の流れを完了できることを確認してください。

domani email create [email protected]
domani email webhook [email protected] --url https://my-agent.example/webhook
domani email webhook-test [email protected]

エントリーポイントに応じて、--surface plugin、--surface skill、または --surface api を使用してください。これにより、認証情報を公開することなく、アクティベーションのアトリビューションを一貫させられます。

これにより domani コマンドがインストールされます。または npx で直接実行できます。

npx domani-cli search myapp .com .dev .ai

クイックスタート

# Domain
domani search myapp .com .io .dev     # Check availability
domani buy myapp.dev                  # Purchase a domain
domani connect myapp.dev vercel       # Auto-configure DNS for Vercel

# Email
domani email create [email protected]               # Create [email protected]
domani email send [email protected] \
  --to [email protected] --subject "Hello" --body "Sent from my terminal"
domani email forward [email protected] \
  --forward-to [email protected]                        # Forward inbound to personal email

# Health
domani status myapp.dev               # DNS, SSL, email, expiry check

使用例

# Find available domains with a budget
domani search startup --expand --max-price 20

# AI-powered name suggestions
domani suggest "minimalist productivity app" --style brandable --tlds com,dev,ai

# Buy multiple domains at once
domani buy startup.dev startup.ai --yes

# Set up Vercel + Google Workspace in two commands
domani connect startup.dev vercel
domani connect startup.dev google-workspace

# Full email workflow: create, send, check inbox, forward
domani email create [email protected]
domani email send [email protected] \
  --to [email protected] --subject "Deck" --body "Here's our deck."
domani email inbox [email protected] --direction in
domani email forward [email protected] --forward-to [email protected]

# Webhook for inbound emails (for bots, support systems, etc.)
# CURSOR_AUTH contains the complete value, e.g. "Bearer sender-key"
domani email webhook [email protected] --url https://myapp.dev/hooks/email \
  --authorization-env CURSOR_AUTH
domani email webhook-test [email protected]

# Provision domain + mailbox + authenticated event webhook in one call.
# The secret stays in the environment; only its variable name is in argv.
AGENT_AUTH="Bearer sender-key" domani provision agent.dev \
  --webhook https://agent.example/inbox --authorization-env AGENT_AUTH

# Export DNS records before making changes
domani dns startup.dev snapshot
domani dns startup.dev set TXT @ "v=spf1 include:_spf.google.com ~all"

# Pipe to jq (auto-JSON when piped, no --json needed)
domani list | jq '.domains[] | {domain, expires_at}'

# Introspect command schemas for agent integration
domani schema buy --json

コマンド

ドメイン

domani search <name> [tlds...]    Check availability across TLDs (--expand for 30+)
domani suggest <prompt>           AI-powered domain suggestions (--style, --lang, --tlds)
domani buy <domains...>           Purchase one or more domains
domani adopt <domain>             Inspect and plan a safe connection or transfer
domani transfer <domain>          Transfer registration, preserving current nameservers
domani renew <domain>             Renew a domain (--years 1-10)
domani import <domain>            Import a domain you own elsewhere (DNS monitoring only)
domani list                       List your domains
domani status <domain>            Health check (DNS, SSL, email, expiry)
domani tlds                       List all TLDs with pricing (--sort, --max-price)
domani whois <domain>             WHOIS/RDAP lookup
domani deals [id]                 Marketplace deals (--role, --status, --limit, --cursor) or one deal

メール

domani email list                    List all mailboxes
domani email create user@domain      Create a mailbox
domani email delete user@domain      Delete a mailbox
domani email inbox user@domain       List messages (--folder, --view, --direction, --since, --until, --cursor)
domani email folders user@domain     List folder and view counts
domani email contacts                Address book (--q, --cursor; --order created for a full sync)
domani email archive user@domain --message-ids m1,m2
domani email trash user@domain --message-ids m1
domani email restore user@domain --message-ids m1
domani email read|unread|star|unstar user@domain --message-ids m1,m2
domani email send user@domain        Send an email (--to, --subject, --body, --cc, --bcc)
domani email forward user@domain     Forward inbound to a personal address (--forward-to)
domani email webhook user@domain     Forward inbound as JSON (--url, --authorization-env, --api-key-env, --clear-headers)
domani email webhook-test user@domain Deliver one signed test event to the configured webhook
domani email setup --domain <domain>       Auto-configure MX, SPF, DKIM, DMARC
domani email status --domain <domain>      Check email DNS health
domani email connect --domain <domain> <provider>   Connect external provider (Gmail, Fastmail, Proton)

Mailzero アシスタント（プライベートプレビュー）

domani assistant today               Now, Needs you, Waiting, Upcoming, Handled
domani assistant settings            Opt-in state, consent, and mailbox scope
domani assistant set                 Change settings (--enable, --shadow, --pause, --mailboxes, --none, --days)
domani assistant preview             Record consent and start a background history import (--mailboxes, --consent)
domani assistant backfill|retry      Follow the import or requeue its terminal failures
domani assistant item <id>           One work item with its Decision and options
domani assistant choose <id>         Record a decision (--item-version, --decision, --decision-version, --option)
domani assistant instruct|snooze|ignore|take-over|correct <id>
domani assistant plan <id>           Exact preview of a prepared reply; nothing is sent by the CLI
domani assistant activity            Content-free interaction and receipt log
domani assistant rules               The standing delegations (match, assignee, level, grants)
domani assistant approvals           The plans waiting for you and the questions your agents asked
domani assistant suggestions         The rules the assistant proposes from what recurred
domani assistant metrics             The seven numbers per account and per rule (--days)
domani assistant task <id>           The task envelope an assignee works from
domani assistant lease|release|effects|escalate|report <id>
domani assistant export|delete       Export or delete derived data (source mail is never touched)

読み取りには assistant:read、変更には assistant:write がトークンに必要です。

DNS

domani dns <domain> get            List all DNS records
domani dns <domain> set <type> <name> <value>   Add/update a record
domani dns <domain> delete <type> <name>        Remove a record
domani dns <domain> snapshot       Export DNS to file
domani dns <domain> restore        Restore DNS from snapshot
domani nameservers <domain>        Get or set nameservers (--reset for defaults)
domani connect <domain> <target>   Auto-configure DNS for a provider
domani route [action] [id]         Short-lived HTTP routes (list: --domain, --status, --limit, --cursor)

対応プロバイダー：Vercel、Netlify、Cloudflare Pages、GitHub Pages、Fly.io、Railway、Render、Google Workspace、Fastmail、Proton Mail。

設定

domani settings <domain>           View/update auto-renew, WHOIS privacy, security lock
domani contact [view|set]          Manage WHOIS contact info
domani parking <domain>            Manage parking page (enable/disable/price)
domani analytics <domain>          View parking analytics
domani auth-code <domain>          Get EPP auth code for outbound transfer
domani transfer-away <domain>      Check outbound transfer status

アカウント

domani login                       Log in to domani.run (opens browser)
domani logout                      Forget the current account's login (--account <name> for another)
domani accounts                    List saved accounts, * marks the one in use
domani use <name>                  Switch the active account
domani me                          Show account info and the CLI account in use
domani billing                     Add or update payment method (opens browser)
domani invoices                    List payment invoices
domani notifications               List notifications (--unread, --limit, --cursor; --read marks all read)
domani token                       Print your API key
domani tokens [list|create|revoke] Manage API tokens (scoped, expiring)
domani webhooks [action]           Manage webhook endpoints (auth headers via --authorization-env/--api-key-env)

イントロスペクション

domani schema [command]            Show command schemas for AI agent integration
domani update                      Update to the latest version
domani uninstall                   Remove domani CLI and config

エージェント連携

人間だけでなく、AI エージェントやスクリプト向けに構築されています。

TTY の自動検出：標準出力がターミナルでない場合、CLI は自動的に JSON 出力に切り替わり、確認プロンプトを省略します。--json フラグは不要です。

domani list | jq '.domains[].domain'

ページネーション：一覧表示コマンドで次のページがある場合は More: --cursor <next_cursor> と表示されます（JSON モードでは next_cursor を読み取ります）。次のページを取得するには、これを --cursor に渡します。

構造化エラー：JSON モードでは、エラーに code、hint、fix_command が含まれ、自動復旧に利用できます。

{ "error": "Not logged in", "code": "auth_required", "fix_command": "domani login" }

コード	修正方法	説明
auth_required	domani login	ログインしていません
payment_required	domani billing	お支払い方法が登録されていません
contact_required	domani contact set	WHOIS の連絡先情報がありません
validation_error	hint を確認	入力が無効です
not_found	-	ドメインが存在しないか、所有していません
rate_limited	Retry-After の時間だけ待機	リクエストが多すぎます

フラグ：

フラグ	説明
--json	JSON 出力を強制
--fields <f>	JSON フィールドを絞り込み（カンマ区切り）
--dry-run	実行せずに変更内容をプレビュー
--yes	確認プロンプトを省略

入力の堅牢化：すべての入力について、パス・トラバーサル、制御文字、クエリ文字列、二重エンコードを検証します。これらはエージェントがよく起こす幻覚です。

スキーマの確認：コマンドを組み立てる前に domani schema <command> --json を実行すると、パラメーターの型、制約、列挙値を確認できます。

お支払い

ドメイン料金は、保存済みのカードに請求されます。domani.run/dashboard または domani card add でカードを追加してください。

domani buy myapp.dev                     # Charged to saved card

認証

方法	説明
domani login	対話形式でログイン（ブラウザーを開きます）
$DOMANI_API_KEY	環境変数として指定する API キー
OS キーチェーン	利用可能な場合、domani login によって保存される認証情報
~/.domani/config.json	秘密情報以外の CLI 設定。キーチェーンのないシステムでは従来の代替手段としても使用

CLI は最初に $DOMANI_API_KEY を確認し、次に保存済みのログイン情報を使用します。

domani login                             # Interactive (opens browser)
export DOMANI_API_KEY=domani_sk_...      # Or set env var

複数のアカウント

CLI では複数の Domani アカウントを名前ごとに保持でき、それぞれに専用のキーチェーンエントリーが用意されます。

domani login --account work              # save a second account as "work"
domani accounts                          # list them; * marks the one in use
domani use work                          # make "work" the active account
domani --account personal list           # use another account for one command
DOMANI_ACCOUNT=work domani mcp serve     # pin an agent's MCP bridge to "work"
domani logout --account work             # forget that login only

コマンドで使用する認証情報の優先順位は、DOMANI_API_KEY、--account、DOMANI_ACCOUNT、アクティブなアカウントの順です。domani me で使用中のアカウントを確認できます。また、購入、更新、移管の確認時には、請求が発生する前にアカウント名が表示されます。以前の CLI バージョンで保存したログイン情報は、何もやり直すことなく default アカウントになります。

スコープ付き API トークンは、domani tokens create --scopes read,dns --expires-in 86400 で作成できます。

環境変数

変数	説明
DOMANI_API_KEY	API キー（保存済み設定より優先）
DOMANI_ACCOUNT	使用する保存済み CLI アカウント（--account より下、domani use より上）
DOMANI_CONFIG_DIR	設定ディレクトリ（デフォルトは ~/.domani）

ライセンス

MIT