Release Notes

Install the latest version

npm install -g @treasuredata/tdx@latest

v0.16.5 (2026-01-20)

New Features

• Chat integration support for agents - tdx agent pull/push/clone now support generic chat integrations (Slack, MS Teams, LINE, etc.) in agent configurations
• Re-evaluate agent test runs - New --reeval flag for tdx agent test to re-evaluate cached test runs with updated prompts or evaluation criteria

Improvements

• Better Engage editor type validation - --editor-type option now shows allowed values in help text and validates input
• Improved Windows authentication - Replaced keychain library for more reliable credential storage on Windows

v0.16.0 (2026-01-16)

Breaking Changes

• Agent pull folder naming - tdx agent pull now preserves Unicode characters, case, and spaces in folder names instead of normalizing them to lowercase ASCII. Existing folders will be auto-renamed to match the new format on pull.

v0.15.0 (2026-01-16)

New Features

• MCP server command - New tdx mcp command to run tdx as an MCP (Model Context Protocol) server, enabling integration with AI assistants like Claude Desktop, Cursor, and other MCP-compatible tools
• Agent testing - New tdx agent test command for automated LLM agent testing with configurable test cases and evaluation metrics

v0.14.7 (2026-01-14)

Bug Fixes

• Claude proxy environment handling - Fixed tdx claude to disable Bedrock/Vertex environment variables when using the TD proxy, preventing conflicts with existing AWS/GCP configurations
• Clearer error messages - Network and API errors now display the root cause instead of generic "fetch failed" messages

Documentation

• Windows WSL2 installation guide - Added step-by-step guide for installing tdx on Windows using WSL2

v0.14.6 (2026-01-13)

Bug Fixes

• Windows shell process - Fixed DeprecationWarning when spawning shell processes on Windows
• Agent pull pagination - Fixed tdx agent pull only retrieving the first 20 agents when more exist

v0.14.5 (2026-01-13)

New Features

• Default profile management - New --default option for tdx use and tdx profile commands to set a profile as the default, plus new tdx profile unset command to remove the default

Bug Fixes

• Windows authentication - Fixed tdx auth setup failing on Windows due to path handling issues
• Windows Claude Code detection - Fixed Claude Code executable not found in PowerShell environments
• Windows spinner display - Reduced spinner flicker on Windows terminals for smoother output

v0.14.4 (2026-01-09)

Bug Fixes

• Usage tracker stability - Corrupted usage log files no longer break tdx claude stats cache rebuilding

v0.14.3 (2026-01-09)

Bug Fixes

• Default site persistence - Running tdx auth setup without --profile now correctly persists the site selection for future commands

v0.14.2 (2026-01-08)

New Features

• .digdagignore support - Workflow push now respects .digdagignore files to exclude files from upload, following gitignore syntax with support for wildcards, negation patterns, and nested ignore files at any directory level

v0.14.1 (2026-01-07)

New Features

• Named profile creation - tdx profile create now accepts an optional name argument to create profiles with specific names in a single command

v0.14.0 (2026-01-04)

New Features

• Interactive workflow session navigation - tdx wf sessions now shows an interactive cursor-based selector in terminal mode, allowing you to navigate sessions with arrow keys and press Enter to view the task timeline
• Type-to-filter sessions - In the interactive selector, type to filter sessions by workflow name for quick navigation through large lists
• Direct timeline navigation - New --session-id and --attempt-id options for tdx wf timeline to jump directly to specific sessions or attempts without interactive selection
• Adaptive terminal layout - Session timeline now uses full terminal width dynamically, with 70% allocated to names and 30% to timeline bars
• Improved session display - Sessions now show project names inline (dimmed) with vertically aligned workflow names for better readability

Improvements

• Task timeline layout - Fixed icon alignment using consistent 2-char width emojis, removed bold formatting from attempt header, and added helpful tip for viewing detailed logs
• Better Esc handling - Pressing Esc in session selector now cleanly exits without selecting a session (workaround for prompts library limitation)
• Cleaner visual hierarchy - Attempt IDs now dimmed, project names shown without bold, better color usage throughout

Bug Fixes

• Fixed double paging - tdx wf sessions | less no longer invokes less twice when piping to external pager
• Workflow project not found - Project not found errors no longer show stack traces, displaying clean error messages instead

Documentation

• Terminal recommendations - Added recommended terminals (iTerm2, Ghostty, PowerShell, WSL2) to introduction for best emoji and color support

v0.13.2 (2026-01-03)

Bug Fixes

• Journey single-file targeting - Fixed tdx journey push and tdx sg pull to correctly filter to a single file when a specific YAML path is specified
• Journey version handling - Improved handling of multi-version journeys during push/pull operations for better reliability

v0.13.1 (2026-01-03)

New Features

• Clickable terminal links - URLs are now automatically clickable in terminal output, removing the need for -w flags to open web console pages
• Journey command alias - New tdx journeys alias for tdx journey list command

Bug Fixes

• Journey round-trip stability - Fixed issues with journey push/pull consistency to ensure clean round-trips without spurious diffs
• Journey push targeting - Fixed single-file targeting when pushing specific journey files
• Empty segment rules - Fixed handling of empty segment rules in tdx sg pull
• Journey list filtering - Fixed tdx journey list to show only the latest version of each journey

Performance

• Faster recursive listing - Optimized API calls for recursive segment/journey listing using /entities/by-folder endpoint

Improvements

• Better list ordering - Improved ordering and display of segments and journeys in list commands

v0.13.0 (2026-01-02)

New Features

• Profile management commands - New dedicated commands for managing profiles:

  • tdx profile - List all profiles
  • tdx profile create - Interactive profile creation with site selection and API key validation
  • tdx profile remove <name> - Remove a profile
  • tdx profile set <key>=<value> - Update profile configuration

• Improved workflow listing - tdx wf projects, tdx wf workflows, tdx wf sessions, and tdx wf attempts now use a cleaner list format with status icons (✅ ❌ 🔄), pagination support via --limit, and glob pattern filtering

Breaking Changes

• Removed tdx context command - Use tdx profile commands instead for profile management

Bug Fixes

• Agent clone context - tdx agent clone no longer switches context automatically after cloning

v0.12.1 (2025-12-28)

New Features

• Environment variable configuration - New TDX_PROFILE and TDX_SITE environment variables for setting defaults in CI/CD and scripting scenarios

Documentation

• Marketing as Code book - New comprehensive guide at tdx.treasuredata.com/book/ covering CDP concepts, segment management, and workflow automation with tdx

v0.12.0 (2025-12-27)

New Features

• Sync-style workflow management - New tdx wf pull and tdx wf push commands for managing workflow projects locally with diff preview before pushing, similar to tdx sg and tdx journey
• Workflow clone - New tdx wf clone --name <new-name> command to copy workflow projects to a new name, useful for deploying to different environments
• Interactive workflow run - tdx wf run without arguments now shows an interactive selector to choose a workflow
• Session context for run - tdx wf run <workflow-name> now works when a default project is set via tdx wf use

Breaking Changes

• Renamed wf push to wf upload - The legacy digdag-style push command is now tdx wf upload. The new tdx wf push is sync-style with diff preview.

v0.11.0 (2025-12-26)

New Features

• Workflow secrets commands - New tdx wf secrets list, tdx wf secrets set, and tdx wf secrets delete commands for managing workflow project secrets
• Default workflow project - New tdx wf use <project> command to set a default workflow project, eliminating the need to specify --project on every command

Bug Fixes

• Connector config normalization - Fixed handling of camelCase legacy settings in activation connector configs

v0.10.1 (2025-12-26)

Bug Fixes

• Journey embedded segments - Fixed an issue where embedded segments could be duplicated when pushing journeys

v0.10.0 (2025-12-26)

New Features

• YAML validation commands - New tdx sg validate and tdx journey validate commands for offline validation of segment and journey YAML files before pushing
  • Validates segment rules, operator types, and required fields
  • Validates journey step references, embedded segment references, and A/B test percentages
  • Shows error locations with line numbers and context

Performance

• Faster pull/push - Optimized API calls and increased parallelization for segment and journey workflows

Improvements

• SDK architecture - Refactored internal SDK structure with cleaner type definitions and modular organization

Bug Fixes

• Journey round-trip stability - Improved segment name handling across multi-version journeys

v0.9.8 (2025-12-23)

New Features

• Journey wait step branching - Wait steps now support different next paths for condition matched vs timeout outcomes

v0.9.7 (2025-12-23)

Bug Fixes

• Journey jump steps - Fixed an issue with jump target resolution

v0.9.6 (2025-12-23)

New Features

• Connection name support - tdx connection schema <name> now accepts connection names in addition to connection IDs

Improvements

• Journey pull/push stability - Improved segment matching and ordering for more reliable round-trip syncing

v0.9.5 (2025-12-22)

New Features

• Directory option - New -C/--directory global option to run tdx commands from a different working directory
• Connector config validation - tdx sg push and tdx journey push now validate connector_config against connection schemas before pushing

v0.9.4 (2025-12-19)

Bug Fixes

• Agent tool handling - Fixed tdx agent pull/push/clone to properly handle all tool types including built-in tools

v0.9.3 (2025-12-19)

New Features

• Text knowledge base support - tdx agent pull/push now support text-based knowledge bases stored as markdown files with YAML frontmatter

v0.9.2 (2025-12-19)

Bug Fixes

• Agent name resolution - Fixed 404 error when using tdx agent pull with certain project names

v0.9.1 (2025-12-19)

Bug Fixes

• Agent clone compatibility - Fixed tdx agent clone failing when source agent has tools without function descriptions

v0.9.0 (2025-12-18)

New Features

• Agent commands - New tdx agent command group for managing LLM projects as local YAML files
  • tdx agent pull/push - Sync LLM project configurations between TD and local files
  • tdx agent clone - Copy an existing LLM project to a new project
• YAML diff preview - Agent pull/push now show YAML diffs before applying changes
• Web console URLs - Agent commands show console URLs for easy navigation

Improvements

• Agent context support - tdx use agent <name> sets the default agent for subsequent commands
• Default agent preference - tdx chat now remembers and uses your preferred default agent

Deprecations

• tdx llm backup/restore commands are deprecated in favor of tdx agent pull/push

v0.8.12 (2025-12-18)

New Features

• Journey push command - New tdx journey push command to push journey YAML files independently from segments
• Web console URLs for journeys - New -w option for tdx journey list/view and tdx sg list to show journey URLs

Bug Fixes

• Stable journey YAML ordering - Journey YAML files now have consistent field ordering to avoid spurious diffs
• Claude Code version check - Added version check (minimum 2.0.20) for td-skills support with clear upgrade instructions

v0.8.11 (2025-12-17)

New Features

• Embedded activations in journeys - Journey YAML files now support embedded activation definitions

Bug Fixes

• Journey segment rule format - Fixed segment rules in journeys to use correct group format matching the UI

v0.8.10 (2025-12-17)

Bug Fixes

• Journey folder default - New journeys now use the parent segment folder as default location

v0.8.9 (2025-12-16)

New Features

• Journey support - tdx sg pull/push now support CDP journeys with a human-readable YAML format

v0.8.5 - v0.8.8 (2025-12-12)

Improvements

• Docker container support - Fixed process ID handling issues when running in containerized environments

v0.8.4 (2025-12-10)

New Features

• SQL file auto-detection - tdx query now auto-detects .sql file arguments and stdin input without requiring flags
• Web console URLs for segments - New -w option for tdx sg list/view to show web console URLs

Improvements

• Unified segment YAML schema - value and values fields are now interchangeable in segment YAML definitions
• Better segment error messages - Syntax errors now show the file path for easier debugging

v0.8.3 (2025-12-09)

New Features

• Continue and resume options - New -c/--continue and -r/--resume options for tdx claude to continue previous conversations

Improvements

• New tdx-skills for Claude - Added tdx-skills/parent-segment and tdx-skills/segment skills for managing CDP parent and child segments via Claude Code
• Improved Claude tool calls - Better handling of tool calls in tdx claude for more reliable interactions
• Enhanced status line - Shows site:account_id in Claude Code status line for better context

v0.8.0 (2025-12-08)

New Features

• Segment YAML management - New tdx sg pull/push commands for managing segment configurations as local YAML files with activation sync
• Connection discovery - New tdx connection list command to discover available connections for segment activations
• User management - New tdx user list command to look up users in your account

Improvements

• Human-readable connection names - Segment and parent segment YAML files now use connection names instead of IDs
• Better ps fields output - Shows attribute names and includes enriched attributes
• Renamed ps info to ps view - tdx ps info renamed to tdx ps view with -w option to open in console

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 command for managing session-level context
• 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.