Datatape
CLI

CLI installation

Install the Datatape CLI to manage agents, tools, and MCP connections from your terminal.

CLI installation

The Datatape CLI (dt) lets you manage agents, call tools, and configure MCP connections from your terminal.

Install via npm

npm install -g @datatape/cli

Or with your preferred package manager:

# yarn
yarn global add @datatape/cli

# pnpm
pnpm add -g @datatape/cli

Verify installation

dt --version

You should see output like:

dt/0.1.0

Authenticate

Browser login (interactive)

dt login

This opens your browser to complete the OAuth flow. Once you authorize, the CLI stores a session token locally.

browser OAuth consent screen during dt

Agent API key login (CI/headless)

For environments without a browser, use an agent API key:

dt login --api-key dt_live_a1b2c3...

Or set it as an environment variable:

export DATATAPE_API_KEY=dt_live_a1b2c3...

When DATATAPE_API_KEY is set, the CLI uses it automatically without requiring dt login.

Use an agent API key for CLI authentication. Each agent key is scoped to the tools assigned to that agent.

Check your identity

After logging in, verify your session:

dt whoami
Signed in as rachid@example.com
Organization: Acme Corp (admin)

terminal showing dt whoami output

Uninstall

npm uninstall -g @datatape/cli

Troubleshooting

ProblemSolution
command not found: dtEnsure your global npm bin directory is in your PATH
dt login hangsCheck that port 9876 (callback server) is not blocked
Unauthorized errorsRun dt login again or check your API key
Wrong organizationRun dt login to re-authenticate and select the correct org

On this page