Repository navigation
✨ The 4.5.0 tour
Secrets per project, private data that stays private, and your phone on every machine. CodeAlta 4.5 is a minor release with plenty of fixes and a lot of quality of life: each project gets its own environment and secrets, a project can be pseudonymized before anything reaches a provider, the phone page reaches every machine you have, several sessions can share one worktree, the providers and plugins have new setup pages, and tabs switch faster. Here is the tour of what is new since 4.4.1.
🔐 An environment and secrets for each project
A project now gives environment variables to its sessions, with an [env] table in its .alta/config.toml that the team can commit: GH_TOKEN = "${secret:ACME_GH_TOKEN}" names a secret of each machine, never its value. Shell commands, agent CLIs, jobs and terminals of the project get them, and sub-projects of a monorepo inherit them. A secret can be limited to some projects, so a token of one repository never reaches the sessions of another. More → (#482)
Settings > Secrets and environment is reorganized in tabs: an Overview of what is set and what needs attention, then Secrets, Variables, Environment, Vaults, Sign-ins and Activity. Set it… adds a secret or a variable that a project names and this computer does not have yet. More →
🕶️ Pseudonymized projects
The new built-in Pseudonymizer plugin keeps personal data away from the provider of a model. In a pseudonymized project, what its sessions send goes out with [PERSON_001], [LOCATION_002] or [IBAN_001] in place of the real values, and the answers come back with the real ones. Detection runs on your computer, with patterns for identifiers and a local model for names, in French, English or several languages. A session that cannot pseudonymize sends nothing. Choose Pseudonymize the project… in the menu of a project. More → (#465, #470)
📱 Your phone, on every machine
The phone page now lists the sessions of every machine your desktop reaches: turn on Show my other machines on the phone and the Machines sheet shows each one with its state, direct or relayed. You read, prompt, answer and start sessions there as on this computer. A headless machine that runs CodeAlta Node serves the phone page itself, with no window and no screen, such as an always-on Mac mini. More → (#456)
🌳 Several sessions in one worktree
A new session can join a worktree that exists, beside the sessions that already work there: the Worktree list of the Workspace chip names each worktree after the first session that works in it. A session in a worktree offers New session in this worktree, and agents do the same with alta session create --worktree-path. A project outside git no longer offers worktree and git choices that cannot work. More → (#477, #460)
💽 What takes your disk
Settings > Storage measures what your projects, their worktrees and your sessions take, and explains the git state of each worktree before you remove it. Clean the build output of the checkouts you choose (bin, obj, node_modules…), only what git ignores, after a confirmation that lists each folder. More → (#452, #453)
🎛️ Providers and plugins, redesigned
The form of a provider is organized in tabs, and General puts first what you need to get going: how to sign in, the CLI it runs, and the usage of your subscription with its limits and when they reset, then the defaults of new sessions. Sessions, Models and Advanced hold the rest, and the form no longer scrolls. Its environment is edited a row at a time, and a key button takes the value from a secret or a vault item. More →
Settings > Plugins shows each plugin as a card with its picture, its icon and color, its author, version and tags, and its switch. Search the plugins, filter them by origin and state, or hide the pictures. Your own plugins get a card too: name an icon and a color in the [Plugin] attribute, and put a plugin.webp beside plugin.cs. More →
⌨️ Faster tabs, and Ctrl+Tab
Ctrl+Tab goes back to the tab you used last: hold Ctrl to see the tabs of the pane in the order you used them. Switching between session tabs no longer blocks the window, even with long transcripts: the panes you leave keep their layout, and hidden sessions stop their clocks and timers. The dock keeps its panes across restarts, and the Welcome page opens only when there is no tab to restore. More → (#468, #469, #471, #472)
🧩 Code Mode scripts you can trust
Scripts of Code Mode got a deep review: agent() and session() keep every option, alta commands keep their arguments and output and go through the hooks of the session, a script no longer holds a turn while it waits for its sub-agents, and a resumed run does not repeat what it already changed. Every command and group of alta has help() in a script, and notify() raises a notification of CodeAlta. The wait tool is gone: scripts wait for what they start themselves. More → (#475)
🧠 Models that follow your endpoint
The models of a provider are read again when you open the model list, from its new Refresh button, and before a send whose model the provider no longer lists. Such a model shows Not offered on the chip, and Send says why instead of doing nothing. A local server that swaps its models needs no restart of CodeAlta. More → (#484, #457)
⚡ One command to install
curl -fsSL https://codealta.io/install.sh | sh # macOS and Linux
irm https://codealta.io/install.ps1 | iex # Windows, in PowerShellThe script installs CodeAlta Desktop with everything it needs, .NET included, for your account only. Run it again to update. More → (#461)
🎁 And also
- Skills in the prompt. Choosing a skill writes
/namein the prompt instead of sending it: keep writing, add another skill, then send. (#478, #479) - Notifications from automations, plugins and scripts. Notify me when a run ends tells you when an automation ends, or only when it fails. (#485, #486)
- Sandbox profiles set variables,
NAME=valueor from a secret, and the scratchpad and temp folders of a sandboxed session are writable for its file tools. (#454, #455) - Model tiers and Adaptive in every Runs with, of issues, scripts and automations;
alta automation create --tier. (#458, #459) - Session info shows the folder of a session, and a deletion that is refused says what holds the session. (#450)
- Older sessions stay within reach of the desktop window. (#483)
- Search shows Claude Code sessions better and no longer finds them by chance letters of their id, and the
#picker closes on a typed issue number. (#464, #467) - MCP settings say why a server of another tool has no Remove. (#474)
- Skills with a
triggersorversionfield are no longer shown as invalid, and your own scripts are no longer labeled as samples. (#451, #466) - Ready for .NET 11: the next major version of CodeAlta runs on .NET 11, and the desktop app offers to install it, so that the update to it starts at once. (#209)
- Claude Code CLI 2.1.328, Codex 0.170.0, and the ACP schema 1.33.0.
🙏 Thank you
To @sailro for the Pseudonymizer, @windischb for the disk usage page and model tiers in Runs with, @xen2 for Ctrl+Tab, the dock that keeps its panes and the search of Claude Code sessions, @tomflenner for the notifications, @lilianmisser for skills in the prompt, @emmanuelbretonbelz for a faster session list, @rvillain and @tobitege for their fixes, and to @nicholas-brooks, @ielcoro, @TechWatching, @TechInterMezzo, @BenjaBobs, @mrpmorris, @MIRIMIRIM, @RickStrahl, @aholeton and @kzu for the ideas and reports that became this release.
All changes
Changes
🚨 Breaking Changes
✨ New Features
- Add the session folder to Session info, with copy and open buttons (#450) (b6ddfd5)
- Add environment variables set by a sandbox profile (#455) (fa6b489)
- Add --tier to alta automation create (#458) (6189453)
- Add the phone page of the Mobile plugin to CodeAlta Node (#456) (82b0efa)
- Add the page of the phones and the node listener to the ports no sandbox reaches (c9dc1d3)
- Add typed session reads and personal fleet command adapters (#456) (a7cef76)
- Add confined per-machine services for built-in plugins (#456) (06ded30)
- Add the ASP.NET Core prerequisite and the phone page to the node packages (#456) (3bc607d)
- Add other machines to the phone page and Connect a phone to a machine (#456) (200be93)
- Add a one-command install for Windows, macOS and Linux (#461) (13cf5f6)
- Add a Copy button to the install commands of the home page (#461) (3cbdff7)
- Add a Star on GitHub button to the Welcome page and release notes (429ba0e)
- Add help() to every alta command and group in scripts (#475) (bdd414b)
- Add sessions that start in an existing worktree (#477) (60bcd0d)
- Add project environment and secret restrictions (#482) (2cfb5d5)
- Add the installation of .NET 11 for the next major version (#209) (36b9d8b)
🐛 Bug Fixes
- Fix skills with a triggers or version field shown as invalid (PR #451) by @tobitege
- Fix the release skill template showing the generated notes inside the tour (78bbabc)
- Fix a refused session deletion not saying what holds the session (#450) (ab8edbf)
- Fix sentences of a refused session deletion shown untranslated (08d53ab)
- Fix a prompt queued for an idle session waiting unsent and uncounted (31c9b05)
- Fix browser tests failing on a busy Windows machine (2f0cc09)
- Fix file tools refused in the scratchpad and temp of a sandbox (#454) (27651da)
- Fix secrets of a sandbox profile that ask before use or change (7d32b4a)
- Fix git refused its configuration while another git replaces it (c6c37f0)
- Fix a model server left running after a restart (47d9eca)
- Fix provider model refresh in desktop settings (#457) (dc460da)
- Fix remote session watchers racing with host disposal (199b2ac)
- Fix Adaptive decisions before queued sends finish (8acc159)
- Fix the Linux menu entry for a .NET in the home folder (#461) (1daa9f6)
- Fix the scrollbar of the install command on the home page (2bc3265)
- Fix search finding Claude Code sessions by chance letters of their id (1aa2010)
- Fix worktree and git choices offered to a project outside git (#460) (4dadd00)
- Fix more git choices outside git and tasks of other projects (#460) (a84706a)
- Fix user scripts shown as samples in the Workflows tab (#466) (00dceba)
- Fix the script library saving under a scope that has no folder (63388ac)
- Fix restored dock tabs showing no content after a restart (9c7696e)
- Fix agent() and session() dropping options in silence (#475) (95641a3)
- Fix alta commands in scripts losing arguments and output (#475) (8b51c71)
- Fix alta calls of scripts bypassing the tool hooks of the session (#475) (d630635)
- Fix scripts holding a turn while they wait for sub-agents (#475) (b5ed7cb)
- Fix gates of alta commands that a deeper path or a plugin root missed (#475) (1159dc1)
- Fix scripts reading pictures and running alta outside their session (#475) (f0d1dbb)
- Fix review findings on agent options, results and texts of Code Mode (#475) (a8bfa6f)
- Fix late tool activity reactivating a finished turn (#475) (fd1ffe5)
- Fix replay repeating completed mutations without consent (#475) (7a9e209)
- Fix script launchers, resumes and cancelled sleeps holding turns (#475) (adbecd6)
- Fix script admission and join finalizers at shutdown (#475) (bf23568)
- Fix fleet script children returning early or outliving the wait (#475) (3956e65)
- Fix search of Code Mode ranking commands before the scripts of the library (#475) (9e893e0)
- Fix search for workflow: and keep the rule of the single call direct (#475) (dc537f6)
- Fix the refusal of the phone page of a machine vanishing at once (4ba4a10)
- Fix the containment rule of timeline rows naming a row without a box (6d85646)
- Fix rows asked for staying drawn until the view moves (#469) (ba35c54)
- Fix prompt cache countdown that showed a minute too many (9060370)
- Fix worktrees prepared ahead left behind, and joinable checkouts (145b6dc)
- Fix skills offered in the prompt that a send does not give (c96bdf3)
- Fix models of Mistral Vibe listed though the account cannot run them (09f92ea)
- Fix Claude Code confirmations that CodeAlta allowed without asking (f00b23b)
- Fix old sessions out of reach in the desktop window (#483) (6a11754)
- Fix disk usage tests that cleaned before the scan had ended (7c875b3)
- Fix waiting notices pushed out of the window by passing toasts (985fb69)
- Fix two tests that failed on loaded CI runners (bfbfe2a)
- Fix the interface id that made Windows Hello unavailable (eab5976)
- Fix model lists that missed the changes of an endpoint (#484) (4de329c)
🚀 Enhancements
- Add disk usage management to Storage settings (PR #453) by @windischb
- Add model tiers and Adaptive to Runs with of issues and scripts (#458) (PR #459) by @windischb
- Enhance the Claude Code rows of the search (PR #464) by @xen2
- Improve Perf of session list: resolve the sandboxes of its rows at once (PR #462) by @emmanuelbretonbelz
- Add pseudonymized projects and the Pseudonymizer plugin (PR #465) by @sailro
- Improve the # picker: close on a typed issue number, ignore pastes (PR #467) by @xen2
- Enhance the Pseudonymizer: English kind names, older models, words never hidden (PR #470) by @sailro
- Enhance startup to open the Welcome page only with no tab to restore (PR #471) by @xen2
- Enhance Ctrl+Tab with a most-recently-used tab switcher (PR #468) by @xen2
- Enhance MCP settings: say why a server of another tool has no Remove (#474) (PR #473) by @rvillain
- Enhance the dock to keep its panes across restarts (PR #472) by @xen2
- Add skills to the prompt instead of sending them at once (#478) (PR #479) by @lilianmisser
- Add notifications for automation runs, plugins and scripts (#485) (PR #486) by @tomflenner
- Enhance the provider form with tabs and environment rows (600f225)
- Enhance the provider form at the default size of Settings (eafb235)
- Enhance the usage of a provider with one limit per line (635eb7f)
- Enhance the Plugins page with cards, pictures, search and filters (fbe1f54)
- Improve Perf of the # picker: one GraphQL request, pages, open issues first (be22664)
- Enhance alta commands for scripts from what the evaluations showed (#475) (22b5cfa)
- Improve Perf of focus changes with a long transcript shown (#469) (37925e1)
- Improve Perf of session tab switch: keep the last panes laid out (#469) (3faa550)
- Improve Perf of hidden session tabs: no clock, timer, list read (#469) (902b350)
- Improve Perf of long transcripts: rows far from the view rest (#469) (09e38d9)
- Enhance Mobile settings with a link to the Mobile tab (a6f39fc)
- Improve Perf of session tab switch: the timeline keeps its rows (#469) (173bc87)
- Improve Perf of style changes: no :has() that restyles the page (#469) (9decf1f)
- Improve Perf of window renders: a brand logo keeps what it drew (#469) (70baf46)
- Enhance ACP bindings to the schema 1.33.0 (2c40a53)
- Enhance Secrets and environment settings (#482) (56bbe99)
- Enhance Secrets and environment: MCP uses, Set it for variables (0584822)
🏭 Tests
- Fix test of the window running out of time for a DevTools answer (d0f7567)
- Fix test of queued attachments reading a prompt already sent (52524d4)
- Fix test of the process tree reading a PID file still written (a1ba4f1)
- Fix test of the startup layout running out of time on a busy machine (d4c8954)
- Fix test waits of the browser tests: one limit for a busy machine (3ffcbbd)
- Fix test of the composer and of Models failing on macOS (f140fed)
- Fix test reads of a vault log while its program appends (1cb00ec)
- Fix test waits for browser overlay navigation (f1e64e7)
- Fix test timing of the database maintenance and source fetch limit (7d8d744)
- Fix test race in owned send cancellation (6934cec)
- Fix test time limits of the Pseudonymizer tests to come from TestTime (5fcd39b)
- Fix test of script questions on a node calling exec outside a turn (#475) (aa89419)
- Fix test of the tab switcher losing its list to a focus change (0ae273b)
- Fix test of the pane in front with sessions kept laid out (#469) (7c8852c)
- Fix test of a server left running that took a dying one for it (4d4b937)
- Fix test of Markdown nesting that timed out on a loaded CI runner (cff6c5c)
- Fix test of the skill picker that moved the caret before the picker (5554a36)
📚 Documentation
- Add doc of the phone page on nodes and of other machines (#456) (51eaeed)
- Update doc of the plan of the phone page on nodes: done (#456) (d984d47)
- Update doc pictures of the provider form (5e87053)
- Update doc picture of the Mobile page of Settings (9981e25)
- Update doc of Secrets and environment with pictures of its tabs (f75f01d)
- Update doc for 4.5.0: Ctrl+Tab picture and front page (101170c)
📦 Dependencies
- Update Dependencies to their latest releases (551e99e)
- Update Dependencies of XenoAtom and SkiaSharp, and the TUI with them (acdc7d6)
- Update Dependencies of the desktop frontend (9f76ffd)
- Bump Claude Code CLI to 2.1.328 and Codex to 0.170.0 (76d28aa)
🧰 Misc
- Update models.dev snapshot (3dab6c6)
Full Changelog: 4.4.1...4.5.0
Published with dotnet-releaser








