# Release Notes

Install or upgrade to the latest version

```bash
npm install -g @treasuredata/tdx@latest
```

## Release Channels

tdx 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


### Installation


```bash
# Stable (default)
npm install -g @treasuredata/tdx@latest

# Next channel (early access)
npm install -g @treasuredata/tdx@next
```

### Switching Channels

To receive update notifications for a specific channel:


```bash
# Switch to next channel
tdx use release_channel next --default

# Switch back to stable
tdx use release_channel stable --default
```

### How It Works

All 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`.

### Treasure Studio

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.

## Versioning

Starting March 2026, tdx uses **calendar versioning** (`vYYYY.M.patch`):

- **Year.Month** identifies when the release was made (e.g., `v2026.3.0` = March 2026)
- **Patch** increments for additional releases within the same month (e.g., `v2026.3.1`)


This makes it easy to see how recent your version is at a glance. Previous releases used semantic versioning (`v0.x.y`). The transition is seamless — all existing upgrade mechanisms work without changes.

## v2026.3.54 (2026-03-31)

### New Features

- Studio now uses Cognito SSO for agent-platform authentication, replacing the legacy TD1 flow


### Improvements

- Queued message rows in Studio chat now use a translucent background for better visual clarity


### Bug Fixes

- Fixed a crash in the Work panel when a goal file has no `status` in its frontmatter


### Security

- Community Registry features (Skills Community tab, Schedules Community tab, Workspace Sharing) are temporarily disabled pending security review


## v2026.3.53 (2026-03-30)

### New Features

- Studio now supports pasting images from the clipboard directly into chat input
- Each Studio window can now use a separate profile with independent authentication
- Added compact kanban card mode with a density toggle for denser board views
- Added goal list sorting, column resizing, and refreshed dark mode color scheme
- Added monospace font size setting in Studio preferences
- Added name filter to the Skills panel for quick searching
- Added Cmd+G shortcut to open the Goal selector command palette
- Added recency sub-groups (Today, This Week, etc.) to the Knowledge sidebar Kind view
- Added `work_create_item` and `work_rename` MCP tools for creating and renaming workspace docs
- Added item-to-goal linking via `goal:` frontmatter in workspace items
- Slack connector now supports channel search and message posting scopes


### Bug Fixes

- Fixed tool cards displaying at full width instead of sizing to fit their content
- Fixed tool card output now shows formatted results with hover effects
- Fixed @ mentions for projects and goals resolving via Tab and click instead of showing raw IDs
- Fixed graph view staying open when navigating away via the sidebar
- Fixed MCP OAuth callback conflicting with Okta connector port
- Fixed agent session tracking not extracting session IDs from all SDK messages


## v2026.3.52 (2026-03-28) — Stable

### Bug Fixes

- Fixed journey preview rendering broken edges and doubled gaps around decision-point merge nodes
- Fixed Community Skills tab appearing for all users — now gated behind a Labs toggle with OAuth support
- Fixed broken themed colors (light/dark mode) in MCP app previews rendering as invalid values


## v2026.3.51 (2026-03-28)

### Bug Fixes

- Fixed `tdx claude` proxy not working with OAuth authentication — now supports Bearer auth with automatic token refresh during long sessions


## v2026.3.50 (2026-03-27)

### Bug Fixes

- Fixed OAuth tokens expiring during long CLI and Studio sessions — tokens now auto-refresh before expiry
- Fixed Studio showing a full-screen login screen when tokens expire — now re-authenticates silently in the background
- Fixed new schedule tasks being saved to the wrong workspace directory
- Fixed schedule task name conflicts — default names now auto-increment (new-task, new-task-1, ...)


## v2026.3.49 (2026-03-27)

### New Features

- **Skill sharing** — Export and import skills between workspaces with automatic content detection
- **OAuth for all sites** — OAuth authentication now available on all sites with improved login experience for both CLI and Studio
- **Loopio RFP connector** — New connector for integrating with Loopio RFP management
- **File sharing from previewer** — Share any file directly from the artifact previewer
- **Workspace file browser** — Modal viewer for sidebar files with full workspace tree view
- **Task detail modal** — View task details in a modal overlay on the kanban board
- **Import modal** — Redesigned import flow with auto-detection of content type
- **Open files from Work chat** — Open workspace files in the task detail modal directly from Work chat
- **Window size persistence** — Studio remembers window size and position across sessions
- **Work sidebar width persistence** — Work sidebar width is preserved between sessions
- **Goal dependency tracking** — Transitive dependency detection for accurate goal progress calculation
- **Page Up/Down scrolling** — Page Up/Down keys now scroll chat messages


### Performance

- Collapse old chat messages for improved rendering performance in long conversations


### Bug Fixes

- Fixed goal selector overlapping layout in schedules/guide view
- Fixed duplicate file-viewer artifacts appearing on chat history load
- Fixed modal content not refreshing when Work chat edits markdown files
- Fixed chat session directories polluting workspace folders
- Fixed Work chat disappearing from Active sidebar section while panel is open
- Fixed working folder not restoring when starting chat from Work page
- Fixed Atlassian connector internal authentication error
- Fixed segment activation push warnings for unrecognized fields and join_row defaults
- Fixed idle Waiting sessions not expiring from Active tab
- Fixed Work chat input height not resetting after sending multi-line messages


## v2026.3.48 (2026-03-26)

### New Features

- **Workspace Sharing** — Share workspaces with your team via the community registry, with public, unlisted, and private visibility options (Labs > Work Management > Workspace Sharing)
- **Join Shared Workspaces** — Browse and join workspaces shared by others from the workspace selector menu
- **Deep link sharing** — Share workspaces via `treasure-studio://workspace/{name}` links that open Studio and join automatically
- **Copy share link** — One-click copy of the share link from the sync controls toolbar


### Bug Fixes

- Fixed cloned workspaces appearing empty after joining a shared workspace


## v2026.3.47 (2026-03-26)

### New Features

- **Work workspace management** — Delete and rename workspaces directly from the Work board
- **Schedule Tasks workspace integration** — Schedule Tasks are now organized within Work workspaces


## v2026.3.46 (2026-03-26)

### New Features

- **Inline AI chat on Work board** — Chat with AI directly from the Work board without switching views


### Bug Fixes

- **Re-authentication screen** — Account info now displays on the re-authentication screen so you know which account to log in with
- **Segment behavior conditions** — Fixed Behavior type being lost during segment push, ensuring idempotent round-trips
- **Segment V5 ruleset envelopes** — Fixed extra envelope wrapping on pull that caused unnecessary diffs
- **AI streaming stability** — Fixed sub-agent results prematurely ending the AI response stream


## v2026.3.43 (2026-03-25)

### Bug Fixes

- **RAG context duplicates** — Fixed duplicate chunks from the same chat appearing in RAG context display
- **RAG context leaking into responses** — Improved RAG context framing to prevent the assistant from reproducing injected context in its output
- **RAG auto-inject default** — Changed RAG auto-inject default to off; users must explicitly enable it in RAG settings


## v2026.3.42 (2026-03-25)

### New Features

- **Community sharing for Schedule Tasks** — Share schedule tasks with the community from Studio
- **Figma Desktop MCP server** — Figma Desktop MCP server added to the MCP catalog
- **Chat history semantic search** — Local RAG system for semantic search across chat history


### Bug Fixes

- **Custom MCP server support** — Fixed stdio custom MCP server not working correctly


## v2026.3.41 (2026-03-25)

### New Features

- **Looker BI connector** — Connect to Looker as a data source in Studio
- **Work page tag filtering** — Filter work items by tags on the Work page
- **Work page goal selector** — Collapsible goal selector for focusing on specific goals
- **Font customization** — Choose UI font and monospace font in Appearance settings
- **Chat History settings** — Dedicated Chat History settings tab with sidebar visibility toggle
- **Session tabs in sidebar** — Active sessions displayed as vertical tab strip in the sidebar


### Bug Fixes

- **Segment activation columns** — Fixed column format for activation push to match expected format
- **Segment Console rulesets** — Preserved Console ruleset envelopes and fixed behavior filter wrapping
- **Studio Welcome screen flash** — Fixed Welcome screen briefly appearing on Work-to-Chat transition
- **Studio chat input cursor** — Fixed multi-line cursor misalignment in chat input


## v2026.3.40 (2026-03-24)

### Improvements

- **Slack time-based queries** — Slack tools now accept human-readable datetime (e.g. "2026-03-24", "2026-03-24 10:00") for time range filtering and include readable timestamps in responses


## v2026.3.39 (2026-03-24)

### New Features

- **Graph timeline layout** — New timeline layout option in the Graph view for visualizing items chronologically
- **Graph work items and goals** — Graph view now displays work items and goals as nodes
- **Slack file tools** — Browse and download files from Slack channels directly in Studio
- **Schedule Task Marketplace** — Browse task templates, run tasks autonomously, and browse generated files from the scheduler
- **Work onboarding guide** — New onboarding guide on the Work page with always-visible Goals section
- **Automatic update checks** — Studio now checks for updates daily and adds a Check for Updates action to the command palette
- **Next channel tracks main** — The 'next' release channel now tracks origin/main HEAD for faster early access


### Work (Lab)

- **Priority review items** — Items requiring review are floated to the top of board lanes
- **Density-aware graph labels** — Graph labels adapt to node density for better readability at all zoom levels


### Bug Fixes

- **Work page font sizes** — Increased font sizes on the Work page for consistency with chat
- **Studio text input** — Fixed text doubling caused by color transition on textarea


## v2026.3.38 (2026-03-23)

### New Features

- **Studio web search citations** — Web search results now display source citations with clickable links
- **Studio message queuing** — Queue your next message while the AI is still streaming a response
- **Activation workflow actions** — New Actions fields for integrating activations with custom Treasure Workflow jobs
- **Studio skills discovery** — New Skills section in the Work sidebar for browsing available skills


### Work (Lab)

- **Hide backlog items** — New toggle to hide backlog items from the Work board
- **Open in Board** — Work item previews now include an "Open in Board" button
- **Auto-filter stale items** — Done and void items are automatically filtered from listings based on file age
- **Improved context display** — Work context chip now uses a multi-row layout with clickable links


### Bug Fixes

- **Activation schedule** — Fixed schedule options not being sent correctly when pushing activations
- **Segment Console visibility** — Segments now produce V5-compliant rules so they appear correctly in the Console UI
- **Segment activation columns** — Fixed activation column data not being read from the correct API field
- **Studio Slack workspace picker** — Slack OAuth now skips the workspace picker when the team is known
- **Studio chat title** — Chat windows now show your first message as the title instead of "New Chat"
- **Studio wiki-links** — Fixed wiki-links to notes and guides not resolving in Work task view
- **Studio status transitions** — Move operations now correctly show status transitions and open tickets as artifacts
- **Studio Shift+Tab shortcut** — The Shift+Tab shortcut now works from anywhere in the Chat window
- **Studio deep link imports** — Shows error feedback for failed deep link imports and fixes artifact reconstruction


## v2026.3.37 (2026-03-23)

### Bug Fixes

- **Studio Slack connector** — Fixed Slack OAuth not working in production builds


## v2026.3.36 (2026-03-23)

### New Features

- **Studio Community Registry** — Browse, install, and share skills and plugins across your organization from the new Community tab in the Skills panel


## v2026.3.35 (2026-03-23)

### New Features

- **Studio Slack connector** — Connect to Slack as an MCP data source with OAuth 2.0 authentication for read-only access to messages, channels, threads, and user profiles


## v2026.3.34 (2026-03-23)

### New Features

- **Studio sub-agent visibility** — Sub-agent tool calls now render as full cards with hierarchy, collapsed to the latest 3 with an expand button
- **Studio Work context in chat** — Active work context appears as a visible chip in the chat input area
- **Studio GitHub links in Work** — Ticket preview and work board now show GitHub PR/issue links
- **Studio progress bar** — Status progress bars now show colored segments for all phases
- **Studio HTML preview** — External Tailwind CSS is now supported in HTML preview artifacts


### Bug Fixes

- **CLI timeout option** — The `--timeout` option now applies consistently across all API clients
- **Studio MCP reconnection** — Shows a meaningful error message when MCP server reconnection fails
- **Studio command palette** — Cmd+K now opens the search overlay without navigating away from the current page
- **Studio working folder** — Fixed the working folder selector dropdown and label display
- **Studio skill marketplace** — Skills from marketplaces without a manifest file are now supported


## v2026.3.33 (2026-03-22)

### New Features

- **Studio Okta connector** — Connect to Okta as an MCP data source with OAuth 2.0 authentication for read-only access to users, groups, and applications
- **Studio unified command palette** — All commands are now accessible from a single palette (Cmd+K), with consistent keyboard shortcuts across menus and toolbar


### Work (Lab)

Work is a new local-first task management system built into Studio and the CLI (`tdx work`). It uses markdown files with git auto-versioning to let you and the AI organize goals, track items, and manage knowledge — all inside your workspace.

- **Workspace switcher** — Switch between workspaces directly from the Work panel
- **Self-evolving workspace** — Workspaces automatically capture learnings and update their own knowledge base as you work
- **Sub-items** — Items now support sub-items with interactive checkboxes and an eye toggle to show/hide completed items
- **Goal filter persistence** — Your selected goal filter now persists across sessions
- **Shortcut change** — Work panel shortcut changed from Cmd+Shift+W to Cmd+J


### Bug Fixes

- **Studio skill autocomplete** — Pressing ENTER now correctly confirms skill selection in the autocomplete popup instead of inserting a newline
- **Studio working folder label** — The working folder label in the sidebar now stays visible at all times
- **Studio wiki-link navigation** — Back navigation now works correctly when browsing markdown wiki-links
- **Studio workspace skills** — Skills are now correctly discovered when switching workspaces
- **Work board tag display** — Fixed tags not rendering correctly when stored as strings


## v2026.3.32 (2026-03-20)

### New Features

- **Studio multi-window support** — Open independent windows with Cmd+Shift+N (File → New Window), each with its own chat session
- **Studio artifact sharing** — Share dashboard artifacts via file export, Google Drive, or GitHub Gist using the new Share button on MCP App cards
- **Work management (Lab)** — New `tdx work` command for AI-native task management with a local markdown-based Kanban board, wiki-links, and git auto-versioning


### Bug Fixes

- **Studio shared chat continuity** — Imported shared chats now include tool call context, so the AI can reference previous tool interactions when continuing a conversation
- **Studio Drive deep link auth** — Clicking a Drive share link without Google Drive connected now shows a helpful dialog instead of failing silently
- **Studio shared artifact rendering** — MCP App artifacts (dashboards, explorers) now render correctly when imported by other users


## v2026.3.31 (2026-03-20)

### New Features

- **Studio find-in-chat search** — Press Cmd+F (Ctrl+F on Windows) to search text within your chat history with match highlighting and prev/next navigation
- **Studio Stitch by Google connector** — Google's Stitch AI design tool is now available as an MCP connector in Studio
- **Studio image copy and save** — Right-click generated images to copy to clipboard or save to disk, with Copy and Download buttons in the image header
- **Composable Audience Studio CLI** — New `tdx cas` command for managing Composable Audiences (zero-copy CDP segments on customer data warehouses like Snowflake, BigQuery, Databricks)


### Bug Fixes

- **Studio profile switching** — Fixed expired or invalid credentials not being detected when switching profiles
- **Studio Windows auto-update** — Update progress now shows as a native Windows notification instead of an HTA popup
- **Studio G2 reviews** — Fixed slow loading and timeouts when fetching G2 product reviews
- **Studio skill operations** — Shows a clear error message when git is unavailable instead of failing silently


## v2026.3.30 (2026-03-19)

### New Features

- **Studio image generation** — Generate images directly in chat via a built-in `generate_image` tool with configurable size and quality


## v2026.3.29 (2026-03-19)

### Bug Fixes

- **Studio upgrade button** — Shows restart feedback when clicking the Upgrade button instead of appearing unresponsive
- **Studio Windows console flash** — Eliminated brief console window flash during background process checks on Windows


## v2026.3.28 (2026-03-19)

### New Features

- **Studio About tab** — New About tab in Settings showing version info and application details


## v2026.3.27 (2026-03-19)

### Bug Fixes

- **Studio Windows auto-update** — Fixed installer not completing reliably on Windows
- **OAuth authentication** — Fixed missing required scope in authorize requests


## v2026.3.26 (2026-03-19)

### Bug Fixes

- **Segment folder navigation** — Fixed root folder lookup failing for segment operations


## v2026.3.25 (2026-03-19)

### Bug Fixes

- **Studio Windows auto-update** — Fixed app not relaunching after completing a Windows update


## v2026.3.24 (2026-03-19)

### Bug Fixes

- **Studio permission mode toggle** — Fixed crash when toggling permission mode while the agent is thinking


## v2026.3.23 (2026-03-19)

### Bug Fixes

- **Studio Windows auto-update** — Switched to one-click installer for more reliable auto-update and relaunch


## v2026.3.22 (2026-03-19)

### Bug Fixes

- **Studio expired auth handling** — Expired authentication is now handled gracefully with in-app guidance instead of suggesting terminal commands


## v2026.3.21 (2026-03-19)

### New Features

- **`tdx policy` command** — View your assigned policies and permissions; admins can list all account policies and inspect specific policies with assigned users


### Bug Fixes

- **Studio Windows auto-update** — Fixed PowerShell signature verification hanging the update process


## v2026.3.20 (2026-03-19)

### Bug Fixes

- **Segment behavior conditions** — Fixed behavior conditions generating incorrect SQL during push
- **Segment nested conditions** — Nested condition groups now produce a warning instead of blocking push


## v2026.3.19 (2026-03-19)

### Bug Fixes

- **Studio Windows auto-update** — Fixed auto-update hanging after NSIS installer download
- **Studio Supervisor mode** — Improved streaming reliability, prompt scoping, and event visibility in Supervisor mode


## v2026.3.18 (2026-03-19)

### New Features

- **Studio desktop notifications** — Receive native OS notifications when a chat completes while Studio is in the background; clicking the notification focuses Studio and navigates to the chat. Configure notification channels (Desktop, Slack) in Settings > General > Notifications
- **Studio RSS feed tool** — Built-in `fetch_rss_feed` tool for reading RSS/Atom feeds without an external MCP server


## v2026.3.17 (2026-03-19)

### Bug Fixes

- **Windows build compatibility** — Fixed Studio build failing on Windows due to shell spawning issues
- **Cross-platform build script** — Fixed `npm run build:info` failing on Windows PowerShell


## v2026.3.16 (2026-03-19)

### New Features

- **Studio G2 connector** — Competitive intelligence via G2 API: search products, view ratings and reviews, track buyer intent signals, and compare competitors


### Bug Fixes

- **Studio sandbox authentication** — Fixed sandbox commands failing to authenticate when using multi-account profiles
- **Studio sandbox tdx version** — The sandbox container now uses the same tdx CLI version as Studio instead of an outdated Dockerfile-bundled version
- **Studio connector availability** — Newly connected (or disconnected) connectors are now immediately available in new chats without restarting
- **Studio Windows panel layout** — Fixed action buttons in Schedules, Projects, Skills, and Graph panels being hidden behind native window controls on Windows
- **Studio session startup** — Fixed chat sessions failing to start when the working directory no longer exists


## v2026.3.15 (2026-03-19)

### Bug Fixes

- **Studio startup crash** — Fixed a blank white screen on startup caused by corrupted chat data
- **Studio sidebar navigation** — Fixed clicking Graph after Schedules not working due to panels not closing each other


## v2026.3.14 (2026-03-19)

### New Features

- **Studio Graph View** — Visualize connections between your chats with a force-directed graph, accessible from the left sidebar


## v2026.3.13 (2026-03-18)

### Bug Fixes

- **Studio Podman detection** — Fixed sandbox mode unable to find Podman when app is launched from Finder, and fixed false "sandbox violation" errors caused by full binary path in security hook checks


## v2026.3.12 (2026-03-18)

### New Features

- **Studio Autonomous Mode** — New Supervisor Agent that enables autonomous multi-step task execution with human oversight via approval/rejection decision points


### Improvements

- **Studio MCP catalog cleanup** — Removed Tavily and Firecrawl MCP server entries from the catalog


### Bug Fixes

- **Studio Podman detection** — Fixed sandbox mode failing to detect Podman in the packaged app by resolving the binary path via the user's login shell


## v2026.3.11 (2026-03-18)

Treasure Studio users
A bug in a previous version causes the "Update" button to not work even though the update prompt appears. If updating fails, please [re-install Treasure Studio](https://studio.treasuredata.com/) manually.

### Improvements

- **Studio app lifecycle** — Active sessions and scheduled tasks are now properly stopped when quitting the app
- **Studio Labs defaults** — All Labs features are now disabled by default for a more stable out-of-box experience


### Bug Fixes

- **Studio system tray** — Removed system tray resident behavior; closing the window now quits the app as expected
- **Studio Google Drive** — Shows a reconnect prompt when Google Drive permissions are insufficient instead of a generic error
- **Studio sandbox file discovery** — Skill and plugin files are now accessible inside the sandbox container for reliable agent file lookups


## v2026.3.10 (2026-03-18)

### New Features

- **Studio web search** — Built-in web search tool for real-time information retrieval during chat
- **Studio chat sharing** — Share chat conversations via Google Drive or local files
- **Studio sandboxed schedule tasks** — Schedule tasks now run inside sandbox containers for secure execution
- **Workflow secrets bulk set** — `tdx wf secrets set` now accepts multiple `KEY=VALUE` arguments in a single command


### Bug Fixes

- **Account switch stability** — Fixed stale state and streaming session leaks when switching accounts
- **Schedule task kill** — Fixed kill command not stopping agent subprocess
- **Command palette z-index** — Fixed command palette appearing behind artifact popups
- **Connector tool filtering** — Unconfigured connector tools are no longer shown in MCP server


## v2026.3.9 (2026-03-17)

### New Features

- **Studio sandbox mode** — Run agent commands in isolated Podman containers for secure code execution (requires Podman installation)
- **Studio Google Drive extension** — Download, upload, manage, and share files directly from Google Drive
- **Studio multi-account profiles** — Support multiple user profiles for the same Treasure Data account
- **Studio project-profile binding** — Optionally bind a project to a specific profile for automatic switching
- **Studio MCP connectors** — Added Firecrawl and Tavily connectors with secure API key storage
- **Studio current time tool** — Timezone-aware current time tool for accurate time-based queries


### Bug Fixes

- **Journey Unicode support** — Preserved Unicode characters in journey activation and step names
- **US01 console URL** — Updated web console endpoint to `console.us01.treasuredata.com`


## v2026.3.8 (2026-03-16)

### New Features

- **Studio OAuth authentication** — Sign in with your Treasure Data account via browser-based OAuth/OIDC flow
- **Studio MCP Playwright** — Added Playwright connector with stdio transport support
- **Studio Windows improvements** — Hidden title bar and silent auto-updates
- **Simple list output** — `tdx profiles` and `tdx user list` now default to a simple list format


### Bug Fixes

- **Relay chat timeout** — Switched to stall-based timeout for more reliable Slack relay streams


## v2026.3.6 (2026-03-15)

### New Features

- **Studio schedule tasks** — YAML-based schedule task system with a visual form editor for recurring agent tasks
- **Studio remote execution** — Execute agent tasks via Agent Platform for server-side processing
- **Studio 1M context windows** — Upgraded to Opus and Sonnet models with 1M token context
- **Studio artifact improvements** — Lazy loading with pagination, download support, and collapse/minimize controls
- **Studio Labs settings** — New Labs tab for experimental feature toggles
- **Studio Windows EV code signing** — Windows builds are now EV code signed for trusted installation


## v2026.3.5 (2026-03-12)

### New Features

- **Studio SemRush connector** — Added SemRush SEO connector to the MCP catalog
- **Studio Slack enhancements** — Post messages and upload files to Slack directly from the agent, with thread history context from Slack relay


## v2026.3.4 (2026-03-11)

### New Features

- **Studio Slack integration** — Talk to your AI agent by mentioning `@treasureclaw` in Slack. Your local Studio instance processes the request and posts the response back to the thread with streaming updates
- **Studio Slack file sharing** — Attach files to Slack messages for the agent to read, and the agent can upload generated files (CSV, HTML, images) back to the thread
- **Studio Slack notifications** — Push completion notifications from Studio to Slack using the bell icon. Reply to notification threads from Slack to continue the conversation
- **Studio Slack settings** — New dedicated Slack tab in Settings to configure relay server URL, working folder, and notification channel


## v2026.3.0 (2026-03-09)

First release using [calendar versioning](#versioning) (`vYYYY.M.patch`).

### New Features

- **Calendar versioning** — tdx now uses `vYYYY.M.patch` format (e.g., `v2026.3.0` for March 2026), making it easy to see how recent your version is at a glance
- **Bearer token authentication** — New `TDX_ACCESS_TOKEN` environment variable for Bearer token auth, useful for CI/CD and service integrations
- **Engage always-on campaigns** — New support for always-on campaign type in `tdx engage campaign` commands
- **Engage auto-pagination** — `tdx engage` list commands now auto-paginate and return complete results
- **Studio file attachments** — Attach files to chat messages with inline and file-saved modes
- **Studio chat timestamps** — Chat list shows time indicators, with full timestamps on hover
- **Studio quick project deselect** — Quickly deselect a project from the `@` popup


### Bug Fixes

- **Parent segment key mapping** — Fixed reversed `parent_key`/`child_key` mapping in `tdx ps pull` and `tdx ps push`
- **Journey deduplication** — Journey list now correctly prefers the launched version when deduplicating bundles
- **Engage template list** — Fixed whitespace handling, status filtering, and sort order for template listings
- **Listing command output** — Standardized listing commands to use simple lists with clickable console hyperlinks
- **Studio concurrent chats** — Eliminated session cross-talk when running multiple chat streams simultaneously
- **Studio chat interruption** — Conversation context is now preserved after interrupting and resuming a chat


## v0.29.5 (2026-03-06)

### New Features

- **Engage template pull/push** — New `tdx engage template validate`, `pull`, and `push` commands for managing email templates as YAML with companion HTML/TXT files
- **Studio tool permissions** — Configure persistent ("Always") and session-scoped permission rules to skip repeated tool approval prompts. Manage rules in Settings > Permissions
- **Studio syntax highlighting** — `/slash`, `!bang`, and `@project` command prefixes are now visually highlighted in the chat input
- **Studio engage template preview** — Preview email templates in the artifact panel with merge tag modes (raw/preview/default), including local YAML file support via `file_path`
- **Studio sandbox mode** — Experimental setting to restrict agent file writes to the working directory using OS-level sandboxing


### Bug Fixes

- **`tdx query --limit`** — Fixed `--limit` flag being ignored when subcommand defaults overrode it; output limits now apply consistently across JSON/JSONL/TSV/table formats
- **`tdx engage template create` default** — Default `--editor-type` changed from `beefree` to `grapesjs` so CLI-created templates preserve HTML when edited in the UI
- **Studio sandbox working dir** — Fixed sandbox write restrictions not applying correctly in default session folders


## v0.29.4 (2026-03-05)

### Improvements

- **Skills release channel** — Skills marketplace now respects your release channel (stable/next), pinning to the matching GitHub release tag
- **Studio command palette** — User-created custom skills now appear in the command palette (`Cmd+Shift+K`)


### Bug Fixes

- **Studio skill selector** — Popup no longer stays visible after typing a space following a command name, preventing accidental message loss


## v0.29.3 (2026-03-05)

### New Features

- **Studio interactive React artifacts** — LLM-generated React components now render interactively in the artifact panel with Recharts support


## v0.29.2 (2026-03-05)

### New Features

- **Journey YAML validation** — Journey YAML now uses Zod schema validation, providing clearer and more structured error messages for invalid journey definitions
- **Activation YAML validation** — Activation definitions (schedule, columns, connector_config, behavior) now have Zod schema validation, catching configuration errors before push


### Bug Fixes

- **Studio permission modes** — Permission modes (Default, Auto-edit, Plan) now correctly enforce tool gating so restricted tools are properly blocked


## v0.29.1 (2026-03-04)

### New Features

- **Studio colored diff view** — Edit tool calls now display a colored diff view so you can see exactly what changed
- **Studio command palette** — Added missing actions to the command palette for faster navigation
- **Studio skills panel** — Skill settings are now consolidated into a single Skills panel for easier management
- **Studio Gainsight tools** — Improved Gainsight connector tools based on real-world usage feedback
- **Studio LLM proxy** — Added LLM proxy for credential isolation, keeping API keys out of the browser


### Bug Fixes

- **AP01 site name** — `ap01` is now the primary site name with `jp01` as an alias
- **Studio resumed sessions** — Fixed `/compact` handling on resumed sessions
- **Studio MCP OAuth** — OAuth tokens now auto-refresh correctly, and multi-instance port conflicts are resolved
- **`tdx sg sql --path`** — Improved error messages and validation when using the `--path` option


## v0.29.0 (2026-03-03)

### New Features

- **Studio custom skills** — Create, edit, and delete your own skills from Settings > Skills > My Skills. Custom skills appear in the slash command popup and skills selector. You can also ask Claude to author skills for you
- **Studio segment preview** — Segment YAML files now render as an interactive visual preview with color-coded rule cards, collapsible rule sets, and a resizable attributes sidebar
- **Studio permission modes** — Choose between Default, Auto-edit (auto-approve file edits), and Plan (read-only) via a new Shield dropdown in the chat bar. Shift+Tab cycles through modes
- **Studio MCP connectors** — Added Datadog, Gainsight, and Atlassian connectors to the MCP catalog
- **Studio native New Folder** — Folder selection dialogs now show the OS "New Folder" button so you can create directories without leaving Studio
- **Segment console URL** — `tdx sg push` now displays the CDP console URL for the pushed segment


### Bug Fixes

- **Segment include/exclude references** — `tdx sg push` now correctly resolves segment names to IDs for include/exclude references instead of sending raw names
- **Segment nested condition groups** — `tdx sg validate` and `tdx sg push` now reject all nested condition groups (Or/And inside And/Or), which the CDP console silently ignores. Use the `In` operator for same-attribute Or conditions instead
- **Studio auth error handling** — Authentication errors now surface immediately with inline error messages when switching profiles, instead of silently failing
- **Studio markdown headings** — Custom heading styles now render correctly in the markdown preview
- **Studio stop button** — The stop button now responds immediately instead of hanging


## v0.28.7 (2026-03-02)

### Bug Fixes

- **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


## v0.28.6 (2026-03-02)

### New Features

- **`tdx upgrade` command** — 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-file` option** — `tdx engage template create` and `tdx engage template update` now 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


### Bug Fixes

- **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


## v0.28.5 (2026-02-28)

### New Features

- **Studio skills dropdown improvements** — Selected skills now sort to the top, and a "Clear all" button lets you quickly deselect all skills


### Bug Fixes

- **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


## v0.28.4 (2026-02-28)

### Bug Fixes

- **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


## v0.28.3 (2026-02-28)

### Bug Fixes

- **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


## v0.28.2 (2026-02-27)

### Bug Fixes

- **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


## v0.28.1 (2026-02-27)

### New Features

- **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


### Bug Fixes

- **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


## v0.28.0 (2026-02-27)

### New Features

- **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+O` to 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 fields` now shows matrix column and table names, making it easier to author segment rules
- **Agent `--agent` flag** — Use `tdx agent --agent <name>` instead of positional arguments for clearer agent selection


### Bug Fixes

- **Artifact rendering** — Artifact cards now render correctly from `--json` query output and `tdx_run` MCP 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


### Improvements

- **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


## v0.27.3 (2026-02-26)

### New Features

- **Campaign YAML workflow** — `tdx engage campaign pull`, `push`, and `validate` commands 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_campaign` MCP 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 up `email_sender_id` values 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_workspace` field in `tdx.json` is now supported for campaign pull/push, eliminating the need to pass `--workspace` every time


### Security

- **Delivery API access restricted** — The delivery-api is not exposed as a general-purpose `APIType`. `tdx api --type delivery` is intentionally blocked since the delivery-api can also send emails. Access is limited to read-only `listEmailSenders` through the `DeliverySDK` only.


### Improvements

- **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


## v0.27.2 (2026-02-25)

### New Features

- **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


### Bug Fixes

- **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


### Improvements

- **Centered welcome chat input** — The chat input on the welcome screen is now centered for a cleaner layout


## v0.27.1 (2026-02-25)

### New Features

- **Journey traffic command** — `tdx journey traffic` shows Sankey chart data with conversion and activation flows
- **Journey columns command** — `tdx journey columns` displays table column-to-step mapping for journey Trino tables
- **Journey activations command** — `tdx journey activations` lists journey activations in flattened format
- **Journey versions command** — `tdx journey versions` lists all versions of a journey bundle, with `version create` and `version view` subcommands
- **Journey stats period filtering** — `tdx journey stats --from/--to` supports date range filtering with history aggregation


### Bug Fixes

- **Segment Between operator** — `tdx sg push` now correctly maps Between operator `min`/`max` to the API format, fixing HTTP 400 errors; `tdx sg pull` now preserves Between bounds
- **Multi-version journey push** — `tdx journey push` now handles multi-version journeys correctly


### Improvements

- **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


## v0.27.0 (2026-02-24)

### New Features

- **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


### Improvements

- **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 `/`


### Bug Fixes

- **Journey version deduplication** — `tdx journey pull` no 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 stats` no longer shows empty values
- **Segment folder structure** — `tdx segment push` now 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 use` now persists the selected project context to the session
- **Workspace validation** — `tdx use` now 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


## v0.26.7 (2026-02-19)

### New Features

- **Grid Dashboard preview** — New generic `preview_grid_dashboard` tool 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_report` tool 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 for `tdx job submit` to specify a result export destination


### Improvements

- **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


### Using Analysis Skills

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.

## v0.26.6 (2026-02-17)

### New Features

- **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


### Improvements

- **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 value` flag syntax for MCP tools


### Bug Fixes

- **Chat input blocked during compaction** - Chat input is now disabled while context compaction is running to prevent unexpected behavior


## v0.26.5 (2026-02-16)

### New Features

- **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


### Bug Fixes

- **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


## v0.26.4 (2026-02-15)

### Bug Fixes

- **Journey preview merge lines** - Fixed merge connector lines overshooting in nested condition waits within journey preview


## v0.26.3 (2026-02-15)

### New Features

- **Branch selector for skill repositories** - Added a branch selector dropdown in Settings > Repositories, allowing you to switch marketplace branches and auto-reinstall plugins


## v0.26.2 (2026-02-14)

### Improvements

- **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


## v0.26.1 (2026-02-14)

### Bug Fixes

- **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


## v0.26.0 (2026-02-14)

### New Features

- **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


### Improvements

- **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


### Bug Fixes

- **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](https://github.com/treasure-data/tdx-studio/releases)


## v0.25.8 (2026-02-13)

### New Features

- **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


### Improvements

- **Updated chart color palette** - Charts now use the Treasure Data color style for better visual consistency


### Bug Fixes

- **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](https://github.com/treasure-data/tdx-studio/releases)


## v0.25.7 (2026-02-13)

### New Features

- **Google Analytics (GA4) integration** - View GA4 properties, run reports, and explore metadata directly in Treasure Studio with OAuth-based read-only access


### Bug Fixes

- **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](https://github.com/treasure-data/tdx-studio/releases)


## v0.25.6 (2026-02-13)

### New Features

- **Parent segment RT and personalization commands** - New `tdx ps rt list`, `tdx ps rt validate`, `tdx ps pz list`, and `tdx ps pz init` subcommands 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


### Bug Fixes

- **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](https://github.com/treasure-data/tdx-studio/releases)


## v0.25.5 (2026-02-13)

### New Features

- **Experimental knowledge bases and artifacts for agents** - `tdx agent pull/push/clone` now support experimental knowledge base and artifact resources for advanced agent development


## v0.25.4 (2026-02-12)

### Improvements

- **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](https://github.com/treasure-data/tdx-studio/releases)


## v0.25.3 (2026-02-12)

### New Features

- **Release channels** - tdx now offers stable and next release channels, allowing early access to new features via `tdx use release_channel next --default` or 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](https://github.com/treasure-data/tdx-studio/releases)


## v0.25.2 (2026-02-11)

### New Features

- **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](https://github.com/treasure-data/tdx-studio/releases)


## v0.25.1 (2026-02-11)

### New Features

- **Redesigned connector catalog** - Browse and manage connected services through a unified catalog with connect/disconnect actions, brand icons, and alphabetical sorting


### Bug Fixes

- **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](https://github.com/treasure-data/tdx-studio/releases)


## v0.25.0 (2026-02-11)

### New Features

- **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


### Performance

- **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](https://github.com/treasure-data/tdx-studio/releases)


## v0.24.0 (2026-02-10)

### New Features

- **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


### Improvements

- **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


### Bug Fixes

- **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](https://github.com/treasure-data/tdx-studio/releases)


## v0.23.0 (2026-02-09)

### New Features

- **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 desc` now displays behavior tables alongside attributes, with new `--output` flag for JSON/TSV output


### Bug Fixes

- **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](https://github.com/treasure-data/tdx-studio/releases)


## v0.22.0 (2026-02-09)

### New Features

- **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


### Improvements

- **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](https://github.com/treasure-data/tdx-studio/releases)


## v0.21.0 (2026-02-05)

### Breaking Changes

- **Removed `tdx llm proxy` command** - The standalone LLM proxy command has been removed. Use `tdx claude` instead, which handles proxy setup automatically.


### New Features

- **HTTP proxy support** - Added proxy support for corporate networks via `--proxy` option, `TDX_PROXY` / `HTTPS_PROXY` environment 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


### Improvements

- **Background auto-updates in Treasure Studio** - Updates now download silently in the background with a non-intrusive status bar, replacing the blocking dialog


## v0.20.2 (2026-02-04)

### Bug Fixes

- **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


## v0.20.1 (2026-02-04)

### Bug Fixes

- **Profile credential resolution** - Fixed `--profile` CLI flag being ignored for credential resolution when keychain is unavailable


## v0.20.0 (2026-02-03)

### Breaking Changes

- **Removed `TD_API_KEY` support** - Use `TDX_API_KEY` instead
- **Removed `.env` file support** - Use environment variables or `tdx auth setup` for credentials


### Improvements

- **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 status` now shows where the active profile came from (CLI flag, session, config, or TDX_PROFILE env)


### Bug Fixes

- **Treasure Studio profile switching** - Fixed profile switching in Treasure Studio to correctly use the selected profile's credentials


## v0.19.2 (2026-02-03)

### Bug Fixes

- **IME input support** - Fixed Treasure Studio submitting chat messages when pressing Enter to confirm IME (Japanese/Chinese/Korean) input


## v0.19.1 (2026-02-03)

### Bug Fixes

- **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


## v0.19.0 (2026-02-02)

### New Features

- **Multi-account support** - Treasure Studio now supports switching between multiple TD accounts
- **Full Claude Code features** - `tdx claude` now supports all Claude Code features on all TD sites (US, JP, EU, AP)


### Bug Fixes

- **Workflow pull stability** - Fixed gzip validation errors (TAR_BAD_ARCHIVE) when pulling workflow projects
- **Workflow pull UX** - Improved `wf pull` behavior in non-interactive mode


## v0.17.0 (2026-01-30)

### New Features

- **Schedule commands** - New `tdx job schedule` commands 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


### Improvements

- **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


### Bug Fixes

- **Chat auto-scroll** - Fixed auto-scroll behavior in Treasure Studio chat
- **Auto-update stability** - Fixed app freeze that could occur after auto-update errors


## v0.16.11 (2026-01-27)

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.

### New Features

- **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`


### Improvements

- **Enhanced chart and tool call display** - Improved visualization of charts and tool calls
- **Markdown file viewer** - File viewer now supports markdown rendering


### Bug Fixes

- **Bedrock/Vertex AI settings conflict** - Fixed an issue when users already have their own Bedrock/Vertex AI settings in .claude/settings.json


## v0.16.8 (2026-01-23)

### New Features

- **Agent test filtering** - New `--tags` option for `tdx agent test` to run specific test subsets


### Improvements

- **Treasure Studio enhancements** - Added chart rendering, artifact panel, model selector, and improved chat history handling


## v0.16.7 (2026-01-21)

### New Features

- **Status command** - New `tdx status` command 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_segment` as a knowledge base tool target


## v0.16.6 (2026-01-20)

### New Features

- **Re-authenticate button in Studio** - Studio app now has a re-authenticate button in the Settings panel for easier credential refresh


### Bug Fixes

- **Windows Studio stability** - Fixed MSYS environment variable handling in Studio on Windows


## 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 [book](/treasure-code/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](https://github.com/treasure-data/tdx/releases).