tdx - AI-Native CLI for Treasure Data

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

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
• 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.0.0 or higher (Node.js 24 Active LTS recommended)
• TD API key with appropriate permissions

Contributing

This project is maintained by the Treasure Data DevAI Unit.