npm install -g @treasuredata/tdx@latesttdx offers two release channels:
- Stable (default) — Thoroughly tested releases, recommended for most users
- Next — Early access to new features before they are promoted to stable
# Stable (default)
npm install -g @treasuredata/tdx@latest
# Next channel (early access)
npm install -g @treasuredata/tdx@nextTo receive update notifications for a specific channel:
# Switch to next channel
tdx use release_channel next --default
# Switch back to stable
tdx use release_channel stable --defaultAll releases are published to the next channel first. After validation, releases are promoted to stable. Stable channel users only see promoted releases in update notifications. You can check your current channel with tdx use release_channel.
In Treasure Studio, you can select the release channel in Settings > General > Release Channel. You can also click Check for Updates to manually check for new versions.
- Grid Dashboard preview - New generic
preview_grid_dashboardtool renders multi-page grid dashboards in the artifact panel. Any skill can use it to visualize KPI cards, gauges, score bars, Chart.js charts, sortable tables, and markdown cells with cell merging - Action Report preview - New generic
preview_action_reporttool renders prioritized action cards with As-Is/To-Be diffs, executive summary, and Copy as Markdown button. Works with any skill that produces structured recommendations - SerpAPI connector - Added SerpAPI as a new connector in Settings > Connected Services, enabling SERP analysis with AI Overview detection
- Auto-preview markdown files - When the AI agent writes or edits a markdown file, a rendered preview automatically appears in the artifact panel
- Job submit result export - New
--result <target>option fortdx job submitto specify a result export destination
- Image zoom - Image artifacts now display inline with click-to-zoom support
- ESC key stops streaming - Press ESC to stop AI response generation (same as the stop button)
- Recommended skill repositories - Settings > Skills now shows recommended repositories for quick setup
- Dashboard validation - Grid dashboard and action report YAML validation now uses Zod schemas, catching incorrect field names and missing required fields with clear error messages
The grid dashboard and action report preview tools are designed to work with analysis skills. To use them, change your td-skills repository branch to feature/add-analysis-skills in Settings > Skills > Repositories.
- Google Search Console connector - Added Google Search Console as a new connector in Settings > Connected Services, enabling SEO AI Agent workflows with tools for search analytics, site listing, URL inspection, and sitemap management
- Compaction status indicator - Studio now shows a visual indicator with spinner when conversation context is being auto-compacted
- Bang command artifacts - Bang commands (
!tdx query ...) now display rich artifacts (tables, MCP App UIs) instead of raw text, and support--key valueflag syntax for MCP tools
- Chat input blocked during compaction - Chat input is now disabled while context compaction is running to prevent unexpected behavior
- Command palette - Added VS Code-style command palette (⌘⇧P) with category filters for Skills, Connectors, Tools, and CLI commands
- Bang commands - Type
!to directly execute tdx CLI commands (!tdx databases) or MCP tools (!preview_journey /path) from the chat input - Slash command autocomplete - Type
/to browse and instantly execute available skills
- Glean connector URL validation - Added real-time validation to prevent entering invalid Glean URLs with API paths (e.g.,
/mcp,/api) - Glean document reader - Fixed schema validation to accept both single URL string and URL array formats
- Journey preview merge lines - Fixed merge connector lines overshooting in nested condition waits within journey preview
- Branch selector for skill repositories - Added a branch selector dropdown in Settings > Repositories, allowing you to switch marketplace branches and auto-reinstall plugins
- Secure connector management - Glean, HubSpot, and Atlassian connectors now use built-in local tools with keychain-stored tokens, replacing remote MCP servers for more reliable connections
- Studio startup update notification - Suppressed transient "Checking for updates..." spinner at startup; update status now only appears for manual checks
- Studio cache crash - Fixed a crash when running inside Treasure Studio caused by attempting to create a cache directory at the filesystem root
- Streaming indicator in chat history - Studio sidebar now shows a streaming indicator for active chats, making it easy to see which conversations are in progress
- Smooth output panel animation - Opening the Studio output panel now uses a smooth slide animation for a more polished experience
- Updated Studio color palette - Studio UI now uses the Treasure Data crystal color palette for a more consistent visual identity
- Cleaner macOS titlebar - Pane headers are integrated into the macOS titlebar zone for a cleaner Studio layout
- Compact tool call display - Single-line tool calls now display more compactly in Studio chat
- Responsive layout - Chat window and buttons adapt better to narrow window sizes
- Welcome screen flicker - Fixed flickering when switching between Studio chats
- Task list pinning - Task-list artifacts now stay pinned to the top of the output panel
- Duplicate status bar - Fixed duplicate status bar appearing when checking for updates from Settings
- SQL preview wrapping - SQL previews no longer wrap unexpectedly, with consistent header labels
Treasure Studio releases: github.com/treasure-data/tdx-studio/releases
- New chart types in Treasure Studio - Added sankey diagrams, treemaps, and funnel charts for richer data visualization
- Atlassian MCP server - Connect Jira and Confluence via OAuth directly from the MCP server catalog
- Journey preview MCP app - Visualize journey YAML files as interactive flowcharts in Treasure Studio
- Internet search toggle - New privacy setting to disable internet search in Treasure Studio for compliance needs
- Updated chart color palette - Charts now use the Treasure Data color style for better visual consistency
- Failed tool call status - Tool calls that fail now correctly display red status indicators in Treasure Studio
- Chart artifact sizing - Chart artifacts now default to compact size for better space utilization
Treasure Studio releases: github.com/treasure-data/tdx-studio/releases
- Google Analytics (GA4) integration - View GA4 properties, run reports, and explore metadata directly in Treasure Studio with OAuth-based read-only access
- MCP tool discovery on macOS - Fixed OAuth tokens not syncing to macOS Keychain, which prevented MCP tools from being discovered after connecting a service
Treasure Studio releases: github.com/treasure-data/tdx-studio/releases
- Parent segment RT and personalization commands - New
tdx ps rt list,tdx ps rt validate,tdx ps pz list, andtdx ps pz initsubcommands for managing RT 2.0 and personalization configurations - Check for Updates button - Manually check for new versions from Settings > General > Release Channel in Treasure Studio
- Chat folder display - Fixed folder names not displaying correctly for existing chats in Treasure Studio
- Output panel cleanup - Fixed output panel staying open when switching chats or creating a new chat
Treasure Studio releases: github.com/treasure-data/tdx-studio/releases
- Experimental knowledge bases and artifacts for agents -
tdx agent pull/push/clonenow support experimental knowledge base and artifact resources for advanced agent development
- Proactive OAuth token refresh - MCP server OAuth tokens are now refreshed automatically before expiry, preventing connection failures due to stale tokens
- Faster skill activation - Reduced latency when activating skills by including installed plugins in the warmup phase
Treasure Studio releases: github.com/treasure-data/tdx-studio/releases
- Release channels - tdx now offers stable and next release channels, allowing early access to new features via
tdx use release_channel next --defaultor in Treasure Studio settings - Connector health check - Test connection button in Treasure Studio connector settings shows diagnostics including latency, token status, and detailed error messages
Treasure Studio releases: github.com/treasure-data/tdx-studio/releases
- Google Drive, Docs, Sheets, Slides integration - Access Google Drive files and read Google Docs, Sheets, and Slides directly in Treasure Studio with OAuth-based read-only access
Treasure Studio releases: github.com/treasure-data/tdx-studio/releases
- Redesigned connector catalog - Browse and manage connected services through a unified catalog with connect/disconnect actions, brand icons, and alphabetical sorting
- MCP tool results stuck - Fixed MCP tool results getting stuck in "running" state in Treasure Studio
Treasure Studio releases: github.com/treasure-data/tdx-studio/releases
- Sub-agent streaming in Treasure Studio - Chat with AI Foundry agents directly inside Treasure Studio with real-time streaming responses and tool activity indicators
- MCP OAuth connector catalog - Connect external services like HubSpot via OAuth directly from Treasure Studio
- Faster chat startup - New chat sessions display content faster by eliminating unnecessary "Initializing..." delays
- Reduced token usage - MCP tool definitions are now loaded on-demand, reducing initial context token consumption
Treasure Studio releases: github.com/treasure-data/tdx-studio/releases
- Google Calendar integration - View Google Calendar events directly in Treasure Studio with OAuth-based read-only access
- Gmail integration - Read Gmail messages directly in Treasure Studio with read-only access
- Conversation search - Search through past conversations in Treasure Studio
- Skills selector - Browse and activate skills directly from the chat input
- Office file inline preview - Preview DOCX, PPTX, XLSX, and HTML files inline in Treasure Studio
- Task list artifacts - Agent task lists now render as interactive artifacts in the chat
- Drag-and-drop tabs - Reorder tabs and artifacts by dragging and dropping
- File path display in tool cards - Edit and Write tool cards now show file paths with click-to-open
- Redesigned welcome screen - Fresh welcome screen with rotating word icons
- Full-screen settings - Settings window now opens full-screen with tabbed navigation
- Slash command feedback - Slash commands now show visual feedback when activated
- Task interruption notification - Chat shows a clear notification when a task is interrupted
- Profile-scoped chat history - Chat history is now filtered by the active profile
- Credit usage history - Fixed credit usage monitor not loading past conversation credits
- Profile switching cleanup - Fixed profile switch not properly cleaning up streaming, artifacts, and attachments
- Dropdown menu transparency - Fixed translucent dropdown menus in the packaged Electron app
- Chat message overflow - Fixed chat messages overflowing their containers
- HTML preview - Fixed HTML preview failing on first render
- Auto updater - Fixed auto updater failing while CI builds release artifacts
- TODO list spinner - Fixed spinner not stopping when chat stream ends or is interrupted
Treasure Studio releases: github.com/treasure-data/tdx-studio/releases
- Credit usage monitor - Treasure Studio now shows real-time AI credit usage (session / today / month) next to the model selector
- MCP server management - Add and manage MCP servers directly in Treasure Studio settings with OAuth2 authentication support
- Skills management UI - Browse, install, and manage skills and custom skill repositories from the Treasure Studio settings panel
- PDF and Office file preview - PDF files now render inline in Treasure Studio; Office files open in external applications
- Account rename and delete - Rename or remove accounts directly from the account selector in Treasure Studio
- Behavior tables in
tdx ps desc-tdx ps descnow displays behavior tables alongside attributes, with new--outputflag for JSON/TSV output
- Tool call cancellation - Fixed cancel action causing 400 errors in Treasure Studio chat
- Chat font size consistency - Fixed inconsistent font sizes across Treasure Studio UI
Treasure Studio releases: github.com/treasure-data/tdx-studio/releases
- Treasure Studio redesign - Refreshed UI with a clean, minimal aesthetic and improved visual hierarchy
- Mid-conversation model switching - Model selector moved to the chat input bar, allowing model changes between messages
- Native macOS dictation - Use macOS dictation to compose messages in Treasure Studio
- Query result viewer - Smarter table column widths, float rounding, and SQL wrapping in interactive query results
- Empty message prevention - Chat input now validates and prevents sending empty messages
Treasure Studio releases: github.com/treasure-data/tdx-studio/releases
- Removed
tdx llm proxycommand - The standalone LLM proxy command has been removed. Usetdx claudeinstead, which handles proxy setup automatically.
- HTTP proxy support - Added proxy support for corporate networks via
--proxyoption,TDX_PROXY/HTTPS_PROXYenvironment variables, or profile config - Interactive query results in Treasure Studio - Query output tables are now parsed into interactive artifacts with sorting, pagination, TSV export, and SQL toggle
- Background auto-updates in Treasure Studio - Updates now download silently in the background with a non-intrusive status bar, replacing the blocking dialog
- Chat context preserved after restart - Fixed conversation context loss when switching between chats or restarting Treasure Studio
- Chat input height reset - Fixed textarea not resetting height after sending a message
- Profile credential resolution - Fixed
--profileCLI flag being ignored for credential resolution when keychain is unavailable
- Removed
TD_API_KEYsupport - UseTDX_API_KEYinstead - Removed
.envfile support - Use environment variables ortdx auth setupfor credentials
- Profile-specific credentials - Support profile-specific API keys via
TDX_API_KEY_<PROFILE>env vars (e.g.,TDX_API_KEY_TD1,TDX_API_KEY_PRODUCTION) - Profile source display -
tdx statusnow shows where the active profile came from (CLI flag, session, config, or TDX_PROFILE env)
- Treasure Studio profile switching - Fixed profile switching in Treasure Studio to correctly use the selected profile's credentials
- IME input support - Fixed Treasure Studio submitting chat messages when pressing Enter to confirm IME (Japanese/Chinese/Korean) input
- Profile switching - Treasure Studio now opens a new chat session when switching profiles
- Auto re-authentication - Treasure Studio automatically re-authenticates when credentials are missing
- macOS window behavior - Treasure Studio now properly quits when the window is closed on macOS
- Multi-account support - Treasure Studio now supports switching between multiple TD accounts
- Full Claude Code features -
tdx claudenow supports all Claude Code features on all TD sites (US, JP, EU, AP)
- Workflow pull stability - Fixed gzip validation errors (TAR_BAD_ARCHIVE) when pulling workflow projects
- Workflow pull UX - Improved
wf pullbehavior in non-interactive mode
- Schedule commands - New
tdx job schedulecommands for managing scheduled queries - MCP Apps support - Treasure Studio now supports MCP Apps with the Parent Segment Explorer app
- Split window support - Treasure Studio now supports split windows for side-by-side viewing
- Artifact recovery - Recover artifacts from tool cards in Treasure Studio chat history
- New chart types - Treasure Studio adds new chart types with improved x-axis label display
- Auto-updater UX - Treasure Studio shows progress indicator and notifications during updates
- Chat auto-scroll - Fixed auto-scroll behavior in Treasure Studio chat
- Auto-update stability - Fixed app freeze that could occur after auto-update errors
Treasure Studio (preview) is now available from the public GitHub release page. Download the .dmg from https://github.com/treasure-data/tdx-studio/releases to install.
- Faster chat session startup - Chat sessions start faster with pre-warming
- Automatic td-skills updates - Latest td-skills are automatically installed and updated
- Auto-updater - Treasure Studio automatically updates when a new version is available
- MCP tool support - MCP tools installed for Claude Code can now be used in Treasure Studio
- Token usage logging - View token usage with
tdx claude usage
- Enhanced chart and tool call display - Improved visualization of charts and tool calls
- Markdown file viewer - File viewer now supports markdown rendering
- Bedrock/Vertex AI settings conflict - Fixed an issue when users already have their own Bedrock/Vertex AI settings in .claude/settings.json
- Agent test filtering - New
--tagsoption fortdx agent testto run specific test subsets
- Treasure Studio enhancements - Added chart rendering, artifact panel, model selector, and improved chat history handling
- Status command - New
tdx statuscommand as a convenient alias that shows both authentication and context status in one view - Parent segment knowledge base support - Agent configurations can now use
parent_segmentas a knowledge base tool target
- Re-authenticate button in Studio - Studio app now has a re-authenticate button in the Settings panel for easier credential refresh
- Windows Studio stability - Fixed MSYS environment variable handling in Studio on Windows
- Chat integration support for agents -
tdx agent pull/push/clonenow support generic chat integrations (Slack, MS Teams, LINE, etc.) in agent configurations - Re-evaluate agent test runs - New
--reevalflag fortdx agent testto re-evaluate cached test runs with updated prompts or evaluation criteria
- Better Engage editor type validation -
--editor-typeoption now shows allowed values in help text and validates input - Improved Windows authentication - Replaced keychain library for more reliable credential storage on Windows
- Agent pull folder naming -
tdx agent pullnow 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.
- MCP server command - New
tdx mcpcommand 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 testcommand for automated LLM agent testing with configurable test cases and evaluation metrics
- Claude proxy environment handling - Fixed
tdx claudeto 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
- Windows WSL2 installation guide - Added step-by-step guide for installing tdx on Windows using WSL2
- Windows shell process - Fixed DeprecationWarning when spawning shell processes on Windows
- Agent pull pagination - Fixed
tdx agent pullonly retrieving the first 20 agents when more exist
- Default profile management - New
--defaultoption fortdx useandtdx profilecommands to set a profile as the default, plus newtdx profile unsetcommand to remove the default
- Windows authentication - Fixed
tdx auth setupfailing 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
- Usage tracker stability - Corrupted usage log files no longer break
tdx claude statscache rebuilding
- Default site persistence - Running
tdx auth setupwithout--profilenow correctly persists the site selection for future commands
.digdagignoresupport - Workflow push now respects.digdagignorefiles to exclude files from upload, following gitignore syntax with support for wildcards, negation patterns, and nested ignore files at any directory level
- Named profile creation -
tdx profile createnow accepts an optional name argument to create profiles with specific names in a single command
- Interactive workflow session navigation -
tdx wf sessionsnow 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-idand--attempt-idoptions fortdx wf timelineto 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
- 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
- Fixed double paging -
tdx wf sessions | lessno 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
- Terminal recommendations - Added recommended terminals (iTerm2, Ghostty, PowerShell, WSL2) to introduction for best emoji and color support
- Journey single-file targeting - Fixed
tdx journey pushandtdx sg pullto 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
- Clickable terminal links - URLs are now automatically clickable in terminal output, removing the need for
-wflags to open web console pages - Journey command alias - New
tdx journeysalias fortdx journey listcommand
- 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 listto show only the latest version of each journey
- Faster recursive listing - Optimized API calls for recursive segment/journey listing using
/entities/by-folderendpoint
- Better list ordering - Improved ordering and display of segments and journeys in list commands
Profile management commands - New dedicated commands for managing profiles:
tdx profile- List all profilestdx profile create- Interactive profile creation with site selection and API key validationtdx profile remove <name>- Remove a profiletdx profile set <key>=<value>- Update profile configuration
Improved workflow listing -
tdx wf projects,tdx wf workflows,tdx wf sessions, andtdx wf attemptsnow use a cleaner list format with status icons (✅ ❌ 🔄), pagination support via--limit, and glob pattern filtering
- Removed
tdx contextcommand - Usetdx profilecommands instead for profile management
- Agent clone context -
tdx agent cloneno longer switches context automatically after cloning
- Environment variable configuration - New
TDX_PROFILEandTDX_SITEenvironment variables for setting defaults in CI/CD and scripting scenarios
- Marketing as Code book - New comprehensive guide at tdx.treasuredata.com/book/ covering CDP concepts, segment management, and workflow automation with tdx
- Sync-style workflow management - New
tdx wf pullandtdx wf pushcommands for managing workflow projects locally with diff preview before pushing, similar totdx sgandtdx 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 runwithout 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 viatdx wf use
- Renamed
wf pushtowf upload- The legacy digdag-style push command is nowtdx wf upload. The newtdx wf pushis sync-style with diff preview.
- Workflow secrets commands - New
tdx wf secrets list,tdx wf secrets set, andtdx wf secrets deletecommands 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--projecton every command
- Connector config normalization - Fixed handling of camelCase legacy settings in activation connector configs
- Journey embedded segments - Fixed an issue where embedded segments could be duplicated when pushing journeys
- YAML validation commands - New
tdx sg validateandtdx journey validatecommands 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
- Faster pull/push - Optimized API calls and increased parallelization for segment and journey workflows
- SDK architecture - Refactored internal SDK structure with cleaner type definitions and modular organization
- Journey round-trip stability - Improved segment name handling across multi-version journeys
- Journey wait step branching - Wait steps now support different
nextpaths for condition matched vs timeout outcomes
- Journey jump steps - Fixed an issue with jump target resolution
- Connection name support -
tdx connection schema <name>now accepts connection names in addition to connection IDs
- Journey pull/push stability - Improved segment matching and ordering for more reliable round-trip syncing
- Directory option - New
-C/--directoryglobal option to run tdx commands from a different working directory - Connector config validation -
tdx sg pushandtdx journey pushnow validateconnector_configagainst connection schemas before pushing
- Agent tool handling - Fixed
tdx agent pull/push/cloneto properly handle all tool types including built-in tools
- Text knowledge base support -
tdx agent pull/pushnow support text-based knowledge bases stored as markdown files with YAML frontmatter
- Agent name resolution - Fixed 404 error when using
tdx agent pullwith certain project names
- Agent clone compatibility - Fixed
tdx agent clonefailing when source agent has tools without function descriptions
- Agent commands - New
tdx agentcommand group for managing LLM projects as local YAML filestdx agent pull/push- Sync LLM project configurations between TD and local filestdx 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
- Agent context support -
tdx use agent <name>sets the default agent for subsequent commands - Default agent preference -
tdx chatnow remembers and uses your preferred default agent
tdx llm backup/restorecommands are deprecated in favor oftdx agent pull/push
- Journey push command - New
tdx journey pushcommand to push journey YAML files independently from segments - Web console URLs for journeys - New
-woption fortdx journey list/viewandtdx sg listto show journey URLs
- 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
- Embedded activations in journeys - Journey YAML files now support embedded activation definitions
- Journey segment rule format - Fixed segment rules in journeys to use correct group format matching the UI
- Journey folder default - New journeys now use the parent segment folder as default location
- Journey support -
tdx sg pull/pushnow support CDP journeys with a human-readable YAML format
- Docker container support - Fixed process ID handling issues when running in containerized environments
- SQL file auto-detection -
tdx querynow auto-detects.sqlfile arguments and stdin input without requiring flags - Web console URLs for segments - New
-woption fortdx sg list/viewto show web console URLs
- Unified segment YAML schema -
valueandvaluesfields are now interchangeable in segment YAML definitions - Better segment error messages - Syntax errors now show the file path for easier debugging
- Continue and resume options - New
-c/--continueand-r/--resumeoptions fortdx claudeto continue previous conversations
- New tdx-skills for Claude - Added
tdx-skills/parent-segmentandtdx-skills/segmentskills for managing CDP parent and child segments via Claude Code - Improved Claude tool calls - Better handling of tool calls in
tdx claudefor more reliable interactions - Enhanced status line - Shows
site:account_idin Claude Code status line for better context
- Segment YAML management - New
tdx sg pull/pushcommands for managing segment configurations as local YAML files with activation sync - Connection discovery - New
tdx connection listcommand to discover available connections for segment activations - User management - New
tdx user listcommand to look up users in your account
- 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 inforenamed totdx ps viewwith-woption to open in console
- Context support for ps commands -
tdx ps validate/preview/runnow 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 pushnow point to correct console-next URL
- Fixed CLI startup error - Resolved missing dependency causing
ERR_MODULE_NOT_FOUNDwhen running tdx
- Parent segment YAML management - New
tdx ps pull/pushcommands for managing parent segment configurations as local YAML files - Parent segment validation -
tdx ps validateto check schema and join statistics against source tables - Parent segment preview -
tdx ps previewto show sample data from master, attributes, and behaviors - Parent segment run -
tdx ps runto push changes and trigger workflow execution - Parent segment info commands -
tdx ps fields/info/desc/sql/showto explore parent segment data - Context support - Set context with
tdx ps useortdx ps pull -uto omit name in subsequent commands
- Unified context commands -
tdx usecommand for managing session-level context - Profile shorthand - New
-pshorthand for--profileoption (e.g.,tdx -p myprofile databases) - Environment variable authentication - Support for
TDX_API_KEYandTDX_API_KEY_<PROFILE>environment variables
- Profile credential precedence - Fixed
TD_API_KEYenvironment variable incorrectly taking precedence over--profilecredential
- Interactive chat selector - New
tdx chatsandtdx llm historycommands with interactive chat selection UI
- Claude usage tracking - New
tdx claude usagecommand 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-proxyoption to skip TD LLM proxy setup fortdx claude
- Experimental feature disclaimer - Added clear experimental status for
tdx claudecommand - Restructured navigation - Merged Architecture section into SDK documentation for better organization
- Updated licensing - Clarified proprietary nature of the project
- Consistent list command structure - All resource types now support
tdx xxx listpattern (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 listwith plural aliases - LLM list commands - Added
tdx llm project list,tdx llm agent listwith plural aliases - Engage list commands - Added
tdx engage campaign list,tdx engage template list,tdx engage workspace listwith plural aliases
- Engage campaign management - Full CRUD operations for campaigns, templates, and workspaces with
create,update,deletesubcommands - Campaign lifecycle commands -
launch,pause,resume,duplicatecommands for campaign management - Workspace session context - Set workspace once with
tdx use engage_workspacefor all subsequent commands - Segment targeting -
--segmentoption to target campaigns by segment path (e.g., "Audience/Segment") - Delivery scheduling -
--start-atand--timezoneoptions for campaign scheduling
- Engage Suite commands - New
tdx engagecommands for managing campaigns, email templates, and workspaces with name-based selection support
- LLM project backup/restore - New
tdx llm project backupandtdx llm project restorecommands for backing up and restoring LLM project configurations
- Improved keychain error handling - Better distinction between "not found" and "access denied" errors with clear guidance to run
tdx auth setup
- 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
.envfiles - Legacy credentials automatically migrated to keychain on first use - Graceful fallback - Works seamlessly in headless environments where keychain is unavailable
- Detailed API error messages - Authentication failures now show helpful error details from the server
- Profile-aware setup -
tdx auth setupshows--profileflag in example commands when using profiles
- New
tdx wf runcommand - 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 logscommand - Rewrote to use correct Digdag API with interactive task selector - Improved attempt output - Vertical format display with expanded params section
- Interactive authentication setup (
tdx auth setup) tdx auth statusas alias fortdx 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
- LLM proxy session context with cache expiration
--lastflag forllm historycommand- File-based logging for LLM proxy
- Build time and git revision in
--versionoutput - Token count estimation for Anthropic proxy
- Various bug fixes and stability improvements
- 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.