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.
- Studio project instructions ignored — Project master instructions were silently dropped in most new chats and after interruptions, so the agent would not follow project-level rules
- Studio artifact panel reopens on chat switch — Switching between chats could cause the artifact panel from a previous chat to reopen unexpectedly
- Studio stop button slow to respond — The stop/interrupt button now responds immediately instead of waiting for the backend to acknowledge the cancellation. The stop button is also now visible during agent questions
tdx upgradecommand — Upgrade tdx with a single command instead of remembering package manager syntax. Supports pinning a version (tdx upgrade 0.28.6) and overriding the package manager (tdx upgrade --method pnpm)- Engage
--html-fileoption —tdx engage template createandtdx engage template updatenow accept--html-file <path>to read HTML content from a file instead of passing it inline - Studio journey version badge — Journey preview now displays the version number (v1, v2, ...) in the header
- Studio conversation preserved on stall — When a stream stall interrupts a Studio conversation, the context is now preserved so you can continue chatting instead of losing the session
- Studio agent hangs — Fixed cases where the agent could hang when asking user questions
- Studio skills dropdown improvements — Selected skills now sort to the top, and a "Clear all" button lets you quickly deselect all skills
- Studio streaming progress — Token counter now updates in real-time during streaming, and the timer resets per step (thinking, tool use, content) instead of showing total elapsed time
- Studio stream stall detection — Studio now detects when the server stops sending data and surfaces the interruption instead of hanging silently
- Journey per-version goals — Multi-version journeys now correctly preserve each version's goal instead of losing them during pull
- Journey draft-only validation — Launched journey versions are no longer validated, since they are immutable
- Studio agent quality — Removed artificial token limits that were cutting agent responses short
- Mermaid diagram flickering — Mermaid diagrams no longer flicker during streaming; source code is shown while streaming and the diagram renders once complete
- Artifact file access — Files written by the agent in Studio session directories can now be opened in the artifact viewer
- Journey goal validation — Missing goal is now a warning instead of an error, so journeys without goals pass validation
- Search panel keyboard input — Fixed search panel (
Cmd+O) not accepting keyboard input after using arrow keys to navigate results - Command palette centering — Command palette and search panel now center on the full viewport regardless of sidebar state
- File path links — File path links in tool cards remain clickable after the artifact is created, scrolling to the artifact on subsequent clicks
- Studio tool permissions — File write and edit tools no longer cause unnecessary permission delays in Studio
- Mermaid diagrams — Chat messages containing Mermaid syntax are now rendered as interactive diagrams in Studio
- Context auto-recovery — Studio automatically recovers from context limit errors via extended context compaction, so conversations can continue without manual intervention
- Interactive Q&A — Studio now supports the AskUserQuestion tool, enabling agents to ask clarifying questions during a session
- Chat history management — Rename, pin, and delete chat history entries in Studio for better organization
- Copy user messages — User messages in Studio now have a copy button for easy reuse
- Bang command ENTER — Fixed ENTER key behavior when using bang commands in Studio
- Mac traffic signals — Project panel header no longer overlaps Mac window controls
- Image preview — The Read tool now shows image previews in Studio
- Projects — Persistent workspaces in Studio let you save and organize your work across sessions. Create, switch, and manage projects from the command palette or sidebar, with export/import support for sharing
- Universal search — Press
Cmd+Oto open a search panel for quickly finding and navigating across your workspace - Chat font size setting — Customize the chat text size in Studio via Settings > General
- New chat from collapsed sidebar — Start a new chat even when the sidebar is collapsed
- Segment field metadata —
tdx sg fieldsnow shows matrix column and table names, making it easier to author segment rules - Agent
--agentflag — Usetdx agent --agent <name>instead of positional arguments for clearer agent selection
- Artifact rendering — Artifact cards now render correctly from
--jsonquery output andtdx_runMCP tool results - Segment pull — Fixed handling of object operator values during segment pull
- Segment validation — Behavior source rules now correctly require a filter
- Engage campaigns — Fixed campaign YAML workflow for EmailSenderId migration
- Agent pull/push — Commands are now resilient to 404 errors from unsupported API endpoints
- Sankey chart labels — Fixed right-side label clipping in Sankey charts
- Chat persistence — Chat messages are no longer lost when toggling the sidebar
- Compact sidebar cards — Chat cards in the sidebar are more compact, showing more conversations at a glance
- Context limit errors — Studio now shows a clear error message when the context limit is exceeded
- Various Studio UI polish: artifact popup positioning, dark mode titlebar, traffic light button alignment, upgrade button accuracy
- Campaign YAML workflow —
tdx engage campaign pull,push, andvalidatecommands let you manage Engage campaigns as YAML + HTML files, enabling campaign creation and editing including HTML email templates - Campaign preview in Studio — New
preview_engage_campaignMCP tool renders a visual 5-tab preview (audience, email content, delivery, activation, UTM) in Treasure Studio - Email senders command —
tdx delivery senders --workspace <name>lists email senders, making it easy to look upemail_sender_idvalues needed for campaign YAML - Campaign console URLs — Campaign list and show commands now include direct links to the Engage console in JSON output
- Workspace context in tdx.json —
engage_workspacefield intdx.jsonis now supported for campaign pull/push, eliminating the need to pass--workspaceevery time
- Delivery API access restricted — The delivery-api is not exposed as a general-purpose
APIType.tdx api --type deliveryis intentionally blocked since the delivery-api can also send emails. Access is limited to read-onlylistEmailSendersthrough theDeliverySDKonly.
- Paginated campaign and template listing — Campaign and template resolution now fetches all pages, fixing issues when workspaces have more than 100 resources
- Deduplicated MCP App previews — Repeated tool calls in Studio no longer create duplicate preview artifacts
- Collapsible sidebar — A new toggle button lets you collapse and expand the Studio sidebar for more workspace
- Chat session resumption — Reopening an existing chat in Studio now resumes the agent session, preserving full conversation context
- Show in Folder for file tools — File tool results now display relative paths and include a "Show in Folder" action to quickly locate files
- JSONL query results — Query result cards now correctly render JSONL-formatted output
- Skill count badge — The skill count badge only appears when skills are explicitly selected, avoiding misleading counts
- Session credits display — The main label now shows only session credits instead of combined totals
- Centered welcome chat input — The chat input on the welcome screen is now centered for a cleaner layout
- Journey traffic command —
tdx journey trafficshows Sankey chart data with conversion and activation flows - Journey columns command —
tdx journey columnsdisplays table column-to-step mapping for journey Trino tables - Journey activations command —
tdx journey activationslists journey activations in flattened format - Journey versions command —
tdx journey versionslists all versions of a journey bundle, withversion createandversion viewsubcommands - Journey stats period filtering —
tdx journey stats --from/--tosupports date range filtering with history aggregation
- Segment Between operator —
tdx sg pushnow correctly maps Between operatormin/maxto the API format, fixing HTTP 400 errors;tdx sg pullnow preserves Between bounds - Multi-version journey push —
tdx journey pushnow handles multi-version journeys correctly
- Journey validation severity — Design-level validation issues in journeys are now reported as warnings instead of errors, allowing push to proceed
- Recommended skill repositories — Added internal skill repository to Studio's recommended list
- Custom MCP server support — Add your own HTTP/SSE MCP servers in Settings > Connectors with automatic OAuth 2.0 authentication when required
- Context window usage display — A color-coded progress bar next to the model selector shows real-time context window consumption with click-to-expand token breakdown
- Auto-compact at 85% context usage — Studio automatically compacts conversation context when usage reaches 85%, preventing unexpected context limits
- Streaming status indicator — Replaces the plain spinner with an animated status showing elapsed time, output token count, and current activity (thinking/writing)
- Working Folder setting — New Settings > Working Folder section lets you configure where file operations occur, with per-session sandboxing by default
- Chart.js visualization plugins — Grid dashboards now support sankey diagrams, treemaps, heatmaps, word clouds, and financial (candlestick) charts
- Recently used commands — Command palette and popups now show your recently used commands at the top for faster access
- Command palette UX — Improved layout, filtering, and keyboard navigation in the command palette
- Keyboard shortcuts — Added
⌘-,(Settings) and⌘-N(New Chat) shortcuts - Slash command discoverability — Improved autocomplete behavior and visual presentation when typing
/
- Journey version deduplication —
tdx journey pullno longer creates duplicate version entries and validates each version independently - Draft journey pull — Draft journeys with incomplete jump steps can now be pulled without errors
- Journey stats —
tdx journey statsno longer shows empty values - Segment folder structure —
tdx segment pushnow preserves nested folder hierarchy correctly - Milestone segment export — Milestone segments referenced by journeys are now included in
tdx journey pull - Segment empty conditions — Empty conditions in segment rules are now caught before push with a clear error message
- Segment behavior filters — Column conditions in behavior filter mapping are now handled correctly
- LLM project context —
tdx llm usenow persists the selected project context to the session - Workspace validation —
tdx usenow validates that the engage workspace exists before saving to the session - Credit usage on profile switch — Studio now refreshes the credit usage display when switching profiles
- Chat textarea scrolling — Large text input in the chat textarea is now scrollable
- Bang command auth — Bang commands now properly inherit authentication context
- Crash-safe settings recovery — Studio settings are now recovered automatically if corrupted by a crash
- 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 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.