tdx - AI-Native CLI for Treasure Data

Status: Under Active Development. SDK/CLI commands are subject to change (2026)

A modern, AI-native command-line interface for Treasure Data, optimized for both human engineers and AI coding assistants.

Documentation: https://tdx.treasuredata.com/

Features

• AI-Native Design: Consistent JSON output, predictable error codes, structured responses
• Claude Code Integration: Launch Claude Code with TD LLM API using tdx claude
• MCP Server: Expose tdx commands as tools for AI assistants (Cursor, Windsurf, VS Code, Claude Desktop)
• Multi-Site Support: Easy switching between US, JP, EU, and AP regions
• Modern Distribution: Install via npx or npm without prior setup

Installation

# Install globally
npm install -g @treasuredata/tdx

# Or run directly with npx (no installation required)
npx @treasuredata/tdx databases

Quick Start

# Set up authentication (interactive)
tdx auth setup

# List databases
tdx databases

# Run a query
tdx query "SELECT * FROM mydb.users LIMIT 10"

# Chat with AI
tdx chat "Show me customer revenue trends"

# Launch Claude Code with TD LLM
tdx claude

Documentation

For detailed documentation, visit https://tdx.treasuredata.com/:

• Getting Started Guide
• Authentication
• Commands Reference
• Claude Code Integration
• TD Skills for Claude Code

Requirements

• Node.js 22.12.0 or higher (Node.js 24 LTS recommended)
• TD API key with appropriate permissions

TDX Studio (Desktop App)

TDX Studio is an AI-native desktop application built with Electron + React. It bundles the tdx CLI.

cd tdx-studio
npm install              # Install dependencies first

# Development (hot reload)
npm run dev

# Production build
cd ..                    # Go back to root
npm run build:ts         # 1. Build tdx CLI first
cd tdx-studio            # 2. Package TDX Studio
npm run package:mac      # macOS (.dmg)
npm run package:win      # Windows (.exe)

See tdx-studio/README.md for detailed documentation.

Contributing

This project is maintained by the Treasure Data DevAI Unit.