Dodo Payments CLI
Manage your Dodo Payments resources, test webhooks, and run AI-powered queries against your account — all from the terminal.
Features
- Interactive TUI — launch
dodowith no arguments to open the full interactive interface with command palette, history, and live notifications. - AI assistant built in — ask questions or take actions in plain English with
/ai. No extra setup, runsdodopayments-mcplocally. - Encrypted at rest — API keys are stored in
~/.dodopayments/config.json, AES-256-GCM encrypted with a machine-derived key. No plaintext credentials on disk. - Auto update — the CLI checks for new versions and notifies you in-app. Run
/updateto upgrade in place. - Webhook tooling — listen for live webhooks or trigger payloads offline for local development.
- Scaffolding support — scaffold billing routes for Next.js, Express, and Better-Auth.
Installation
We provide multiple ways to install the CLI.
Note: Node.js 18+ is enough for CLI subcommands such as
dodo login. The interactive TUI (dodowith no arguments) requires Bun when installed through a package manager. Standalone release binaries require neither runtime.
Using npm
npm install -g dodopayments-cli
Using Bun
bun install -g dodopayments-cli
Manual installation (no Node / Bun required)
-
Download the binary for your platform from the latest GitHub Release.
-
Rename the binary to
dodo:- Linux / macOS:
mv ./dodo-cli-* ./dodo && chmod +x ./dodo - Windows:
ren .\dodo-cli-windows-x64.exe .\dodo.exe
- Linux / macOS:
-
Move it to a directory on your
PATH:- Linux / macOS:
sudo mv ./dodo /usr/local/bin/ - Windows:
move .\dodo.exe C:\Windows\System32\dodo.exe(requires admin)
- Linux / macOS:
-
(Optional) Verify the download against
SHA256SUMS.txtpublished with each release:shasum -a 256 -c SHA256SUMS.txt
Authentication
Before using authenticated commands you need to log in:
dodo login
…or, from inside the interactive TUI:
/login
The login flow will:
- Open your browser to the Dodo Payments API Keys page.
- Prompt you to paste your API Key.
- Ask you to select an environment — Test Mode or Live Mode.
- Store the credentials encrypted at
~/.dodopayments/config.json(AES-256-GCM, machine-bound key).
Upgrading from v3.0.x? Your previous keychain-stored credentials won't carry over — just run
dodo loginonce to re-authenticate.
Switching modes / logging out
You can keep one Test Mode and one Live Mode key authenticated at the same time. To clear credentials, use:
dodo logout
# or, in the TUI
/logout
The logout flow lets you choose between All accounts, Test Mode, or Live Mode independently.
Usage
You can use the CLI in two modes:
1. Interactive TUI (recommended)
Just run:
dodo
This launches the full interactive interface. Type / to open the command palette, or just start typing — anything that isn't a slash command is sent to the AI assistant.
Use:
/helpto see all commands./exit(or pressEsctwice) to quit./clearto clear the screen./updateto upgrade to the latest version when one is available.
2. Direct subcommands
You can also run commands directly without entering the TUI:
dodo <category> <sub-command> [args...]
For example:
dodo payments list 1
dodo customers list
dodo wh trigger payment.success http://localhost:3000/webhook
The reference tables below show every command. In the TUI, prefix them with /; in direct mode, drop the /. Commands marked (TUI only) are interactive wizards and only work inside the TUI.
AI Assistant
Ask questions or take actions in natural language. The assistant uses dodopayments-mcp running locally — no additional setup or OAuth flow required, and your AI traffic doesn't leave your machine except to talk to the model provider.
Examples:
how much revenue did I make this week?
/ai create a new customer named Acme Inc.
/ai find my last failed payment
The assistant respects your active environment (Test / Live).
Products
Payments
Customers
Discounts
Licenses
Addons
Refunds
Checkout
Webhooks
Manage and test webhooks directly from the CLI.
In the TUI, omitting the args (/wh listen or /wh trigger) opens an interactive wizard. In direct mode (dodo wh …), both arguments are required.
The interactive /wh trigger flow guides you through:
- Setting a destination endpoint URL
- Selecting a specific event to trigger
Note:
/wh triggerdoes not require login. It works as a local/offline webhook payload generator.
Note: Triggered events are not signed yet. While testing, disable webhook signature verification on your endpoint — for example, use
unsafe_unwrap()instead ofunwrap()in your webhook handler during testing only.
Note:
/wh listenrequires a Test Mode API key. Live Mode keys are not supported by the listen flow.
Supported Webhook Events
Init commands
Session commands
Updates
The CLI checks for a newer version on startup and surfaces a notification in the status bar when one is available. To upgrade:
/update
Or, if you installed via a package manager, the usual npm i -g dodopayments-cli / bun i -g dodopayments-cli will also work.
Contributing
We welcome contributions from the community — whether you're fixing bugs, adding new features, or improving docs.
Please read our Contributing Guide to get started. We also have a Code of Conduct that we expect all contributors to follow.
Ways to contribute
- Report bugs and suggest features
- Improve documentation
- Add new CLI commands
- Write tests
- Review pull requests
Support
- Discord Community — chat with the team and other users
- GitHub Issues — report bugs or request features
- Documentation — learn more about Dodo Payments
License
This project is licensed under the GNU General Public License v3.0 or later — see the LICENSE file for the full text.
Dodo Payments CLI — manage Dodo Payments resources from the terminal.
Copyright (C) 2025 Dodo Payments
This program is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.