// cli · published on npm

your domain portfolio, from the terminal.

Audit what you are overpaying on, see what expires next, and search for new names without opening a browser tab. One command, no install.

$ npx owndle audit

  47 domains · 6 registrars · £1,284.61/yr
  12 overpaying · £606.61/yr recoverable

  ofone.com        godaddy   £22.99  →  cloudflare  £8.57   save £14.42
  jrny.io          namecheap £48.50  →  porkbun     £32.00  save £16.50
  supper.club      godaddy   £14.99  →  spaceship   £9.98   save £5.01
  …

Illustrative output — your figures come from your own portfolio, priced against the same catalog behind the public price pages.

getting started

# no install needed
npx owndle help

# store your API key (dashboard → settings)
npx owndle login

# or set it per-command / in CI
OWNDLE_API_KEY=owndle_sk_… npx owndle audit

Node 18 or newer. The package is on npm as owndle, MIT-licensed.

commands

owndle audit — renewal and resale audit of the whole portfolio — annual cost, recoverable savings, what is expiring, estimated resale value.
owndle domains — every tracked domain with registrar, expiry date, renewal cost and a valuation.
owndle search <name> — availability, cheapest registrars ranked by five-year cost, alternatives scored on TLD trust and brandability, and social handle checks.
owndle watches — the watchlist — domains you do not own yet, with the lifecycle stage of each.
owndle watch <domain> — start tracking a domain somebody else owns.
owndle mcp — run the MCP server over stdio, for Claude Code, Cursor and other MCP clients.

it is also an MCP server

owndle mcp starts a Model Context Protocol server over stdio, which means Claude Code, Cursor or any MCP client can query your portfolio directly — “which domains am I overpaying on”, “what expires in the next 90 days” — rather than you running commands and pasting output.

Setup and the full tool list are on the MCP server page, and there is a walkthrough in auditing your renewal costs with Claude Code.

why a CLI for this

Domain admin is the kind of work nobody schedules. It matters a few times a year and is invisible the rest of the time, so it gets done when you happen to think of it — which is usually while you are already in a terminal registering the next one.

A dashboard requires you to decide to go and look. A command you can run in four seconds does not. That is the whole argument, and it is the same reason the agent integration exists.

what it reads

The same data as everything else here: registration records pulled from each TLD’s authoritative registry over RDAP, priced against a renewal catalog covering 18 registrars and 70 TLDs. Sourcing is documented on the methodology page.

questions people actually ask.

How do I install the owndle CLI?

You do not have to. `npx owndle <command>` fetches and runs it on demand, which is usually what you want for something used a few times a year. If you would rather have it permanently, `npm i -g owndle` installs it globally. It needs Node 18 or newer.

Do I need a paid plan to use the CLI?

For anything touching your portfolio, yes — the CLI authenticates with an API key, and keys are a Founder-tier feature and above. The free tier covers the web dashboard and ten domains. The free web tools need no account at all.

Where do I get an API key?

Mint one in your dashboard settings. Then either run `owndle login` to store it, or set it as the OWNDLE_API_KEY environment variable — useful in CI, where you would not want an interactive login step.

Can I check domain prices without an account?

Yes, on the website. The price comparison, expiry checker, bulk WHOIS, registrar lookup and domain search are all public pages needing no signup. The CLI is aimed at working with a portfolio you own, which is what the key authenticates.

Is it open source?

The CLI and MCP server package is MIT-licensed and published to npm. It is a thin client over the public REST API at /api/v1, so if you would rather script against the API directly, nothing stops you.

// stop checking one at a time

try it against nothing first.

npx owndle search yourname works without an account — availability, five-year cost by registrar and social handles. When you want the portfolio commands, the dashboard is free for ten domains and API keys unlock at the Founder tier.

start free — 10 domains →

// no card · magic-link sign-in · alerts at 90/30/7/1 days