tdx

Appearance

Release Notes ​

Install the latest version

bash
npm install -g @treasuredata/tdx@latest

v0.7.2 (2025-12-05) ​

Bug Fixes ​

  • Context support for ps commands - tdx ps validate/preview/run now use context parent segment when name is omitted
  • Fixed ps pull -u - Context now updates even when local file is already up to date
  • Fixed parent segment URL - Console links after tdx ps push now point to correct console-next URL

v0.7.1 (2025-12-05) ​

Bug Fixes ​

  • Fixed CLI startup error - Resolved missing dependency causing ERR_MODULE_NOT_FOUND when running tdx

v0.7.0 (2025-12-04) ​

New Features ​

  • Parent segment YAML management - New tdx ps pull/push commands for managing parent segment configurations as local YAML files
  • Parent segment validation - tdx ps validate to check schema and join statistics against source tables
  • Parent segment preview - tdx ps preview to show sample data from master, attributes, and behaviors
  • Parent segment run - tdx ps run to push changes and trigger workflow execution
  • Parent segment info commands - tdx ps fields/info/desc/sql/show to explore parent segment data
  • Context support - Set context with tdx ps use or tdx ps pull -u to omit name in subsequent commands

v0.6.0 (2025-12-03) ​

New Features ​

  • Unified context commands - tdx use and tdx context commands merged into a single consistent interface
  • Profile shorthand - New -p shorthand for --profile option (e.g., tdx -p myprofile databases)
  • Environment variable authentication - Support for TDX_API_KEY and TDX_API_KEY_<PROFILE> environment variables

Bug Fixes ​

  • Profile credential precedence - Fixed TD_API_KEY environment variable incorrectly taking precedence over --profile credential

v0.5.1 (2025-12-01) ​

New Features ​

  • Interactive chat selector - New tdx chats and tdx llm history commands with interactive chat selection UI

v0.5.0 (2025-11-29) ​

New Features ​

  • Claude usage tracking - New tdx claude usage command to view Claude API usage statistics with profile filtering
  • AI Suite credit monitoring - Real-time credit consumption displayed in Claude Code status line
  • Flexible proxy control - New --no-proxy option to skip TD LLM proxy setup for tdx claude

Documentation ​

  • Experimental feature disclaimer - Added clear experimental status for tdx claude command
  • Restructured navigation - Merged Architecture section into SDK documentation for better organization

Other Changes ​

  • Updated licensing - Clarified proprietary nature of the project

v0.4.6 (2025-11-28) ​

New Features ​

  • Consistent list command structure - All resource types now support tdx xxx list pattern (e.g., tdx database list, tdx table list, tdx job list)
  • Plural command aliases - Use plural forms as shortcuts: tdx databases, tdx tables, tdx segments, tdx jobs
  • Workflow list commands - Added tdx wf project list, tdx wf session list, tdx wf attempt list with plural aliases
  • LLM list commands - Added tdx llm project list, tdx llm agent list with plural aliases
  • Engage list commands - Added tdx engage campaign list, tdx engage template list, tdx engage workspace list with plural aliases

v0.4.5 (2025-11-28) ​

New Features ​

  • Engage campaign management - Full CRUD operations for campaigns, templates, and workspaces with create, update, delete subcommands
  • Campaign lifecycle commands - launch, pause, resume, duplicate commands for campaign management
  • Workspace session context - Set workspace once with tdx use engage_workspace for all subsequent commands
  • Segment targeting - --segment option to target campaigns by segment path (e.g., "Audience/Segment")
  • Delivery scheduling - --start-at and --timezone options for campaign scheduling

v0.4.4 (2025-11-27) ​

New Features ​

  • Engage Suite commands - New tdx engage commands for managing campaigns, email templates, and workspaces with name-based selection support

v0.4.2 (2025-11-27) ​

New Features ​

  • LLM project backup/restore - New tdx llm project backup and tdx llm project restore commands for backing up and restoring LLM project configurations

Bug Fixes ​

  • Improved keychain error handling - Better distinction between "not found" and "access denied" errors with clear guidance to run tdx auth setup

v0.4.0 (2025-11-26) ​

Secure API Key Storage ​

  • Keychain-based credential storage - API keys now stored securely in system keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service)
  • In-memory credential cache - 5-minute TTL cache reduces keychain lookups
  • Auto-migration from .env files - Legacy credentials automatically migrated to keychain on first use
  • Graceful fallback - Works seamlessly in headless environments where keychain is unavailable

Authentication Improvements ​

  • Detailed API error messages - Authentication failures now show helpful error details from the server
  • Profile-aware setup - tdx auth setup shows --profile flag in example commands when using profiles

v0.3.5 (2025-11-26) ​

Workflow Command Improvements ​

  • New tdx wf run command - Start workflow attempts directly from CLI with parameters and custom session time
  • Reorganized attempt subcommands - tdx wf attempt <id> [logs|tasks|kill|retry] for better UX
  • Fixed tdx wf logs command - Rewrote to use correct Digdag API with interactive task selector
  • Improved attempt output - Vertical format display with expanded params section

v0.3.0 - v0.3.4 (2025-11-25 - 2025-11-26) ​

  • Interactive authentication setup (tdx auth setup)
  • tdx auth status as alias for tdx auth
  • Pre-installed sql-skills and workflow-skills plugins for Claude Code
  • tdx-basic skill instruction in Claude Code prompt
  • VitePress documentation site with GitHub Pages deployment
  • TypeDoc SDK API documentation
  • Renamed proxy.log to tdx.log
  • Fixed ephemeral shell detection for consistent session IDs
  • Various dependency updates and bug fixes

v0.2.x (2025-11-20 - 2025-11-24) ​

  • LLM proxy session context with cache expiration
  • --last flag for llm history command
  • File-based logging for LLM proxy
  • Build time and git revision in --version output
  • Token count estimation for Anthropic proxy
  • Various bug fixes and stability improvements

v0.1.x (2025-11-14 - 2025-11-19) ​

  • Initial release
  • Core CLI commands: database, table, query, job
  • CDP segment management
  • Workflow commands
  • LLM/Chat integration with TD LLM API
  • Claude Code integration (tdx claude)
  • Multi-site support (US, JP, EU, AP)
  • Context management (profiles, sessions)
  • Multiple output formats (table, JSON, JSONL, TSV)

For detailed changelogs, see GitHub Releases.

Copyright 2024-present Treasure Data