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/cliOr with your preferred package manager:
# yarn
yarn global add @datatape/cli
# pnpm
pnpm add -g @datatape/cliVerify installation
dt --versionYou should see output like:
dt/0.1.0Authenticate
Browser login (interactive)
dt loginThis opens your browser to complete the OAuth flow. Once you authorize, the CLI stores a session token locally.

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 whoamiSigned in as rachid@example.com
Organization: Acme Corp (admin)
Uninstall
npm uninstall -g @datatape/cliTroubleshooting
| Problem | Solution |
|---|---|
command not found: dt | Ensure your global npm bin directory is in your PATH |
dt login hangs | Check that port 9876 (callback server) is not blocked |
Unauthorized errors | Run dt login again or check your API key |
| Wrong organization | Run dt login to re-authenticate and select the correct org |