Changelog
What's new in Truss.
Follow the runtime, clients, and integrations as they ship. Each update moves Truss toward one consistent agent experience across your computer, editor, terminal, and phone.
- Moved the resizable Git workspace pane below Files, where the persistent chat-history list previously consumed sidebar space.
- Made conversations available from a compact Chats control in the Agent header, with a modal for selecting, deleting, and creating chats.
- Added the active Desktop version to the top bar so installed builds are identifiable at a glance.
- Normalize JSON-string tool arguments from compatible providers before execution, while returning malformed arguments to the model as actionable recovery feedback.
- Guarantee non-empty string tool results before they are returned to a provider, preventing malformed tool adapters from ending a run with strict content-validation errors.
- Keep existing tool approvals, permission policies, and structured-tool-call safety boundaries unchanged.
- Added a safe, provider-neutral master prompt template layer for Desktop, VS Code, CLI, TUI, and runtime-hosted clients.
- Supports literal XML alongside a small documented set of XML-escaped workspace, repository, mode, session, and timestamp variables.
- Rejects empty, malformed, unknown-variable, and oversized templates before a model request while keeping Truss mode safety, permissions, and credentials outside user templates.
- Added a versioned runtime-host handshake so Desktop, VS Code, Neovim, and the gateway reject incompatible external runtimes before a session starts.
- Added a separately released, checksum-verified Runtime host with explicit installation, activation, status, and rollback commands instead of silent code replacement.
- Kept trusted embedded fallbacks in place when a managed runtime is missing, altered, offline, or incompatible, while compatible Node clients can take future runtime fixes through normal package updates.
- Moved authenticated gateway event-stream lifecycle, reconnection state, and event parsing out of the Mobile presentation module.
- Moved session creation and mode replacement validation plus streamed assistant-message, tool-approval, and tool-failure projections into a typed Mobile controller boundary.
- Added direct coverage for event authentication, event forwarding, message streaming, approval policy behavior, and versioned session transitions.
- Moved trusted QR pairing parsing, saved-gateway updates, and persisted mode and approval preferences into focused Mobile helpers.
- Moved gateway command and workspace-discovery transport into a typed boundary with preserved authentication, request versions, timeout messages, and gateway-specific error guidance.
- Added direct tests for pairing safety, preference normalization, gateway replacement, endpoint selection, command authorization, rejected requests, and workspace discovery.
- Moved terminal command submission, process interruption, bounded output, prompt context, and development-server preview detection into a dedicated Desktop controller.
- Moved the terminal form, Ctrl+C handling, output scrolling, and repository/time prompt rendering out of the renderer composition file while preserving the existing terminal experience.
- Added focused coverage for command execution, idle and active interruption, preview deduplication, output bounds, and workspace/Git prompt projection.
Desktop 0.1.43Focused Git controller
- Moved repository status, history, staged-file selection, and Git action orchestration into a dedicated Desktop controller.
- Moved Git panel rendering and event wiring out of the renderer composition file while preserving staging, discarding, pulling, pushing, committing, generated messages, syntax indicators, and automatic Files refresh.
- Added focused coverage for repository projections, graph lanes, destructive confirmations, commit-message generation, remote safety, and post-action refresh behavior.
- Required OpenRouter-routed backends to support every supplied request parameter whenever Truss workspace tools are available.
- Sent an explicit automatic tool choice for OpenRouter agent requests while leaving tool-free generation and every other OpenAI-compatible provider unchanged.
- Kept tool-like assistant text non-executable: only structured provider tool calls can enter Truss's approval and execution path.
- Updated the shared provider and agent-host packages alongside every rebuilt host client for one coordinated release.
- Moved conversation creation, updates, removal fallback, and active selection into a dedicated chat controller.
- Centralized primary-agent run lifecycle, stream throughput state, visible tool activity, pending attachments, and slash-file selection behind one tested state boundary.
- Extracted reusable workspace-file fuzzy matching and grounded slash-reference parsing while preserving the existing file search and chat attachment behavior.
- Added focused coverage for conversation transitions, run completion and cancellation, activity restoration, attachments, slash navigation, and workspace references.
- Moved editor-tab selection, dirty state, file/diff modes, persisted editor restoration, virtual Settings-tab exclusions, and syntax diagnostics into a dedicated editor controller.
- Moved file-tree entries, search state, expanded and loaded directories, copied-file state, path validation, and directory-state transitions into a dedicated workspace-files controller.
- Added focused coverage for tab fallback, Settings persistence safety, syntax-state changes, directory listings, expansion and loading, copied files, and traversal-safe file actions.
- Preserved existing open, save, format, media, diff, file-tree, context-menu, workspace restore, automatic refresh, and keyboard behavior.
- Moved editor, preview, Agents, and Chat surface selection plus Chat docking and collapse behavior into a dedicated layout controller.
- Centralized sidebar and terminal splitter behavior, keyboard resizing, Git collapse, and responsive sidebar track calculations behind one tested layout boundary.
- Moved provider-account selection, settings configuration construction, MCP draft state transitions, and settings DOM lookup out of the renderer composition file.
- Added focused controller coverage while preserving the existing Desktop settings, provider, MCP, pane-resizing, and Chat layout behavior.
- Established a single typed preload boundary and centralized shared renderer state, configuration, provider-model metadata, credential-storage status, and conversation selectors.
- Moved custom-theme validation and application, Markdown parsing and rendering, syntax highlighting, and responsive sidebar calculations into focused renderer modules without introducing a framework or changing the Desktop UI.
- Added DOM-independent coverage for renderer state, bridge availability, theme safety, Markdown structure and link handling, code-language aliases, and pane resizing and collapse behavior.
- Enabled Git commit-message generation with the selected BYOK cloud provider as well as local models, using the account credential already stored by Desktop.
- Made the multi-agent control center responsive, added persistent per-agent tool permissions, isolated managed-agent plans from the primary chat plan, and automatically refreshes Files and Git after a managed agent changes the workspace.
- Reorganized the Electron main process around focused services for window lifecycle, updates, secure credentials, persisted state, provider settings, runtime sessions, managed agents, Truss Go, workspace files and media, Git, terminal processes, and typed IPC registration.
- Preserved existing Desktop behavior while reducing the main-process composition entrypoint from 2,927 lines to under 350 and isolating Electron adapters from testable application services.
- Added focused coverage for configuration and model metadata, state persistence bounds, encrypted and session-only credentials, workspace path and media safety, and Git status and commit-message helpers.
- Aligned Desktop Truss Go pairing with the stable port used by the other hosts and Android client, with tested gateway cleanup and a clear conflict message when another host already owns the port.
- Reorganized the terminal client around dedicated runtime-session, terminal-process, workspace-file and editor, keyboard-control, layout, and Ink presentation modules.
- Preserved chat, approvals, settings, local-model discovery, MCP status, agent profiles, file search and Git diff, terminal interruption, preview detection, focus cycling, and responsive terminal layouts while reducing the TUI entrypoint from 1,931 lines to under 500.
- Added focused coverage for transcript rendering, responsive layout and focus transitions, preview URL safety, and generated-directory filtering during workspace discovery.
- Reorganized the VS Code extension into focused controllers for runtime transport, conversations, providers and secure accounts, managed agents, Truss Go, updates, Git assistance, workspace commands, inline completions, and webview presentation.
- Kept the existing commands, settings, provider behavior, conversation concurrency, cancellation, approvals, and serialized service messages compatible while reducing the activation entrypoint from 1,888 lines to under 450.
- Added focused coverage for model configuration, cloud discovery metadata, conversation restoration limits, attachment validation, and concurrent inline-response buffering.
- Let independent VS Code conversations run at the same time, each with its own runtime session, streaming output, tool activity, approvals, and conversation history.
- Made Stop cancel only the selected conversation's request, including an immediate cancel while its runtime session is still starting.
- Kept a second send in the same conversation blocked until that conversation finishes, while other conversations remain available.
- Fixed the model settings panel error during saved-key checks and restored the quick model selector as a dropdown.
- Added a daily update check for manually installed VSIX builds, plus a Command Palette action that links directly to the newest signed VSIX GitHub Release.
- Temporarily removed MCP configuration and management from the VS Code interface while preserving existing stored configuration and runtime support.
Desktop 0.1.36 · VS Code 0.1.20 · CLI 0.1.20 · TUI 0.1.16Sakana Fugu BYOK
- Added Sakana Fugu as a first-class API-key provider across Desktop, VS Code, the CLI, and TUI, using its OpenAI-compatible chat-completions endpoint.
- Added named-account and environment-variable support through SAKANA_API_KEY, without storing a raw key in workspace or normal configuration files.
- Made fugu-ultra available as the recommended model ID for Fugu Ultra accounts while preserving manual model entry and provider model discovery.
- Let Chat inspect and search the workspace with read, list, search, and grep tools, so codebase questions can be answered from the actual project.
- Kept Chat strictly non-mutating: it cannot write files, apply patches, run terminal commands, or create implementation plans.
- Limited Chat MCP access to servers explicitly marked read-only, matching the existing Plan-mode safety boundary.
- Hardened the VS Code-hosted Truss Go gateway, made the paired Android workspace open automatically, and showed clear connection progress while it starts.
- Added signed VSIX GitHub Release delivery, with direct download and manual-install guidance on the Downloads page.
- Reworked Desktop Settings into a full editor workspace with clearer local-model, cloud-provider, and application sections.
- Added a startup update notice when a newer Desktop version is available, with a direct path to update settings.
- Made Hide collapse the complete Chat panel and splitter, with a compact Chat control to restore it without wasting editor space.
- Marked the VS Code extension as Beta on the Downloads page while the client continues to mature.
- Simplified the Desktop menu and made the Agent panel's Hide and Full size controls immediately available instead of nesting them in a second menu.
- Made Ctrl+C interrupt the complete Truss-managed terminal process tree, including shell-launched development servers.
- Allowed saves to complete even when format-on-save finds syntax errors, then marked affected editor tabs, file-tree entries, and Git entries in red with the diagnostic details.
- Enabled Desktop tab autocomplete for configured cloud models through the saved provider credentials.
- Recovered malformed model tool-call JSON as a retryable tool error instead of stopping the agent before write_file could be retried safely.
- Coordinated the runtime, provider, MCP, gateway, agent-host, CLI, TUI, VS Code, and Desktop release versions for the next publication.
- Added a visible, collapsible tool-activity trace and a dockable full-size Agent workspace without exposing hidden model reasoning.
- Let Preview follow announced local development servers while rejecting ambiguous or unsafe URLs.
- Added format-on-save and kept workspace editor state separate from virtual settings and diff tabs.
Desktop 0.1.26BYOK model selection
- Added authenticated provider model discovery and a selectable model list to Desktop BYOK settings, while retaining manual model-ID entry for providers that do not list models.
- Kept chat, editor, and terminal input available after creating, selecting, or deleting Desktop conversations by releasing focus before the conversation controls are replaced.
- Added Xiaomi MiMo as a first-class BYOK provider across Desktop, VS Code, and the CLI, using its OpenAI-compatible API and MIMO_API_KEY credential.
- Added Ollama Cloud as a credentialed native-Ollama provider using OLLAMA_API_KEY, without changing the key-free local Ollama workflow.
- Kept provider credentials out of configuration files and usable by named provider accounts, CLI profiles, and independently configured managed agents.
- Redesigned the full-height Truss split with colorscheme-aware panel contrast, a status Winbar, clearer conversation, plan, activity, and changed-file sections, and an actionable empty state.
- Added panel-local keyboard controls for choosing Chat, Plan, and Edit before starting a request, opening the prompt explicitly, starting a new conversation, testing a connection, inspecting MCP status, selecting a profile, and showing in-panel help.
- Stopped the panel from forcing focus to the bottom while streaming, so users can inspect prior output without the cursor jumping away.
Desktop 0.1.24 · VS Code 0.1.14 · CLI 0.1.15 · TUI 0.1.11Named provider accounts
- Added named API-key accounts in Desktop and VS Code, with secure per-account storage, legacy-key migration, replacement, removal, and agent account selection.
- Added CLI provider-account references with account-scoped environment variables and preserved those opaque references in managed-agent profiles without storing secrets in configuration.
- Kept provider-wide environment variables and existing BYOK setups as compatible fallbacks while laying the groundwork for future provider-specific OAuth adapters.
0.1.23Linux credential storage
- Selected Electron's GNOME/libsecret credential backend for installed Desktop builds on Linux so provider keys can persist through the Secret Service keyring.
- Kept the clear session-only fallback when a host has no available secure credential storage.
0.1.22Desktop startup recovery
- Kept Desktop open when a saved cloud-provider credential is unavailable at startup, so Settings remains available for key re-entry on session-only Linux systems.
- Hardened startup cleanup so a failed previous runtime cannot prevent the Desktop shell from opening.
- Added a clean lazy.nvim installation path backed by a generated plugin-root distribution branch and versioned nvim-v release tags.
- Added :checkhealth truss diagnostics for Neovim and CLI compatibility, executable resolution, workspace access, and optional Git support without contacting a provider.
- Added centralized compatibility metadata, a published version matrix, release validation, and pinned plain-Neovim and lazy.nvim integration smoke coverage.
- Expanded truss.nvim with Chat, Plan, and Edit commands, rendered plans and tool activity, bounded diagnostics and active-file Git diff context, and safe changed-file navigation.
- Added host-routed approval prompts with native write previews, named CLI profile selection, provider connection testing, credential-free MCP status, and opt-in LazyVim mappings.
- Extended the versioned local-service capability handshake without moving credentials, provider policy, MCP execution, or runtime logic into Lua.
CLI 0.1.12Neovim chat preview
- Added a versioned newline-delimited JSON-RPC 2.0 local-service protocol with capability negotiation, bounded inputs, lifecycle events, targeted cancellation, and deterministic shutdown.
- Added the first truss.nvim preview with a native streaming split, reusable conversations, current-buffer or visual-selection context, cancellation, and lazy.nvim setup.
- Kept the original JSON-lines service shape available for released VS Code clients during migration.
0.1.21Managed MCP connections
- Added managed MCP controls in Desktop and VS Code for configuration, enable/disable, isolated connection testing, reconnect, removal, and safe tool inspection.
- Added CLI and TUI MCP status surfaces plus read-only gateway protocol v3 visibility in Truss Go without exposing executable configuration or credentials.
- Removed stale tools during MCP reconnects and made Desktop recover safely when a session-only Linux provider key expires.
- Added a safe Test connection action in Desktop BYOK settings, plus matching CLI and VS Code commands.
- Explained invalid keys, insufficient provider credit, unavailable models, rate limits, and network failures without exposing secrets or provider response bodies.
- Kept Desktop keys available for the current app session when Linux encrypted credential storage is unavailable, with a clear session-only disclosure.
- Accepted streaming SSE and ordinary JSON responses from OpenAI-compatible BYOK providers, including content-part arrays and complete tool calls.
- Stopped sending empty tool definitions in plain Chat mode and replaced silent empty completions with a clear provider-response error.
- Kept chat, editor, terminal, and file-action inputs usable after creating, switching, or deleting Desktop conversations on Linux.
- Added workspace-local agent profiles that can use different local or BYOK providers, endpoints, models, modes, and approval policies.
- Added coordinated concurrent Chat and Plan runs, safe queued Edit runs, per-run approvals, stop controls, and recent run details across Desktop, VS Code, the CLI, and host-authorized Truss Go connections.
- Added bounded, workspace-local terminal run history and secret-safe runtime lifecycle records for cleanup diagnostics.
- Kept completed agent responses available in run details and hardened cancellation, restart, and Linux file-menu behavior.
- Made the desktop file-tree context menu reliable on Linux, including repeated use and file or folder creation without closing the app.
- Added a clearer Truss Go showcase with real Android screenshots and responsive single-column presentation on phones.
- Standardized marketing-page margins, mobile navigation, theme controls, and solid documentation menus across light and dark themes.
0.1.15Runtime reliability
- Hardened tool-call parsing so malformed or incomplete model arguments fail clearly and can recover instead of derailing the conversation.
- Aligned internal package versions used by release builds.
- Refreshed the user-facing README and responsive marketing layouts.
0.1.14Desktop workspace polish
- Improved editor keyboard workflows, chat file references, terminal context, tool activity, settings-tab behavior, and workspace pane resizing.
- Made desktop themes apply consistently across workspace panels and custom themes.
- Ensured Truss-managed development servers stop when the desktop app exits.
0.1.13Linux and settings fixes
- Fixed Arch Linux package dependencies and improved Linux launcher icon metadata.
- Bundled the formatter required by the desktop Format action.
- Reworked settings and resizable workspace sections so all controls remain reachable.
0.1.12Settings in the editor
- Moved desktop settings from a popup modal into a normal editor tab.
- Reused the existing Settings button to open, focus, or close that tab.
0.1.11Linux release experience
- Improved Linux release packaging for Debian, Fedora, Arch, and portable builds.
- Added application-wide zoom controls and more flexible desktop workspace sizing.
- Polished responsive website layouts and added deployment observability.
0.1.10Desktop agent workflow
- Polished the desktop agent workspace, editor, Git, terminal, and approval workflow.
- Fixed the download site so it selects the latest desktop release instead of an unrelated tagged release.
- Refreshed client versions and shared brand assets.
- Stabilized Truss Go startup, same-Wi-Fi pairing, reconnect behavior, and Android branding.
- Improved the mobile conversation, approval, and connection experience.
- Polished the desktop workspace, syntax presentation, agent feedback, and usage metrics.
- Required edit tasks to complete through verified tool actions and improved release reliability.
0.1.6Workspace persistence
- Improved desktop workspace persistence and expanded the public client pages.
- Added BYOK cloud providers alongside local model endpoints.
- Added desktop themes and custom theme support.
- Expanded the public website, documentation navigation, downloads, roadmap, and client content.
- Added Truss Go for Android with trusted QR pairing from Desktop and VS Code.
- Added mobile workspace streaming, approvals, verified tool outcomes, navigation, and chat attachments.
- Kept provider credentials on the host while exposing explicit connection controls.
- Expanded desktop workspace editing and Git controls.
- Added terminal UI themes and refined the website foundations.
- Added desktop update support and workspace file filtering.
- Improved Windows release packaging and GitHub asset upload reliability.
- Added client screenshots to the documentation.
- Added interactive CLI setup and persistent chat sessions.
- Improved Windows executable discovery for CLI and terminal clients.
- Bundled the runtime into the VS Code extension and normalized local-provider configuration.
0.1.0Initial public release
- Released the shared local-first runtime with provider-neutral tools, persistent workspace state, plans, memory, and approval controls.
- Shipped four ways to work: CLI automation, a full-screen terminal UI, a VS Code extension, and the standalone desktop workspace.
- Added local-model discovery for Ollama, LM Studio, llama.cpp, and compatible endpoints, plus Git-aware tools and streaming agent events.
