Revdoku CLI

The revdoku command reads email and attachments, replies to senders and uploads files from your terminal. AI agents can run it too.

You need: macOS or Linux with bash and curl, a browser to sign in, and a Revdoku account: create a free mailbox. You do not need a card.

1. Install

Run this command:

curl -fsSL https://revdoku.com/install.sh | bash

The installer puts the command in ~/.revdoku/bin/revdoku. It also installs the Revdoku skill for the AI agents that it finds on your computer.

2. Add the command to your PATH

Add this line to your shell profile, for example ~/.zshrc or ~/.bashrc. Then open a new terminal.

export PATH="$HOME/.revdoku/bin:$PATH"

3. Sign in

Run any command. The first time, the CLI opens Revdoku in your browser. Sign in and choose the account and the mailboxes.

revdoku accounts

4. Read your email

List the emails in a mailbox. Mailbox IDs start with bkt_.

revdoku emails --mailbox-id MAILBOX_ID

Common commands

The docs list every command.

Installed the skill with npx?

npx skills add revdoku/revdoku --skill revdoku -g installs the skill for your AI agents, but it does not add revdoku to your PATH. Your agent runs the bundled scripts/revdoku.sh from the skill folder instead. To use the command yourself, run the installer above. See Install the Revdoku skill.