What Is the Tomba CLI?

The Tomba CLI (Command-Line Interface) is a tool that lets you use Tomba directly from your terminal. You can search for emails, verify addresses, and more — all without opening a browser.

📦 Install the CLI

Before you can sign in, make sure you have the Tomba CLI installed.

You can install it using one of the following methods:

Using Homebrew (macOS/Linux):

brew install tomba-io/tap/tomba

Using Go:

go install github.com/tomba-io/tomba/cmd/tomba@latest

For more installation options, see the Tomba CLI documentation.

🔐 Sign In with Device Flow (Recommended)

The easiest way to sign in is using the device flow. This opens your browser so you can approve the sign-in securely.

Open your terminal and run:

tomba login

The CLI will display a verification code and a URL, then open your browser automatically. You'll see something like this in your terminal:

Opening browser for authentication...Enter this code: ABCD-1234Waiting for approval...

In your browser, you'll see a page asking you to enter or confirm the code.
Enter the code (or confirm it matches) and click Approve.
Go back to your terminal — you should see a success message. You're now signed in!

🔑 Sign In with an API Key

If you prefer, you can sign in using your API key instead:

First, find your API key in your Tomba account settings. See How to find my API key? for help.
Run the following command:

tomba login --api-key

When prompted, paste your API key and secret.
You're now signed in!

✅ Check Your Login Status

To verify that you're signed in:

tomba whoami

This will show your account email and current plan.

🚪 Sign Out

To sign out of the CLI:

tomba logout

This removes your saved credentials from the device.

💡 Tips

Device flow is more secure — It uses your browser session and doesn't require copying API keys around.
Multiple machines — You can sign in on as many devices as you need. Each creates its own session.
Environment variable — You can also set TOMBA_API_URL if you need to point to a different API endpoint.

Need Help?

Got questions? Contact our support team we're here to help!

Login to the Tomba CLI