♻️ Refactoring
- Retire Network, managed Sandbox, and Bridges (#681)
🎉 Features
- Calmer, plain-language web UI for everyday users (#683)
- Continue and fork sessions across agents, with fallback account routes (#684)
- Shell rail v2 with light and dark themes (#687)
🐛 Bug Fixes
- Wake creator on child turn completion (#685)
- Resolve reported runtime, catalog and delivery failures (#686)
- Restore release nightly coverage and package extension runtimes
Release Notes
Breaking Changes
Remove Network, Bridges, and managed Sandbox products
CompozyOS now centers on local agent sessions, Tasks, Loops, memory, and explicit Gateway access. Network, Bridges, and managed Sandbox capabilities are removed from all product surfaces with no compatibility aliases. HEARTBEAT, SOUL, Task autonomy, Goal nodes, session supervision, attention notifications, task status cursors, and provider-native execution policies remain supported.
Migration
Back up the daemon state and workspace .compozy/ directories before upgrading. Export any retired
product history using the previous release first. Migration 00121_retire_network_bridges_sandbox.sql
permanently drops Network state and wake runs, Bridge instances/routes/deliveries and task subscriptions,
notification presets/delivery permits, Network-actor triage state, and retired fields on retained records. It clears retained Task
references to removed Network wake runs and removes Loop channel-message events. Retained local sessions,
Tasks, ordinary runs, workspaces, memory, SOUL, and HEARTBEAT state are preserved.
Remove Network, Bridges, and managed Sandbox configuration and request fields. Port scripts and extensions
to the current CLI, routes, tools, and SDK; no replacement messaging or remote Sandbox feature is provided.
Gateway requirements move to [gateway] with gateway.private / gateway.public permission atoms,
gateway_requirement_digest, and --confirm-gateway-requirement / confirm_gateway_digest confirmation.
The previous Gateway consent tuple remains recorded. Legacy network_participation manifests must
be rebuilt with [gateway] and their new requirement digest confirmed; no legacy manifest conversion
or implicit Gateway authorization is provided.
There is no in-place downgrade. Restore a complete pre-upgrade backup before running an older binary. See the migration guide for the state disposition and integration changes.
Highlights
A calmer desktop shell with light and dark themes
The CompozyOS desktop is redesigned around flat chrome and edge-to-edge windows, and it now comes in light and dark.
- The dock moves to a slim rail on the left. Its foot holds your profile, the theme toggle, and Settings. Below 960px it becomes a bottom tab bar with the same controls.
- The top bar runs the full width. Desktop dots and an All desktops button sit in its tray, next to the bell and the command palette.
- Windows tile edge to edge with no gaps. A single hairline separates them: drag it, or focus it and use the arrow keys (hold Shift for bigger steps), to resize the panes on both sides.
- New windows open as a tab in the window you are working in instead of floating on top of it; on
an empty desktop they fill it. Option-click a rail icon to open it split beside your window,
Shift-click to open it on a new desktop, or right-click it for every destination, including a
floating window.
compozy window open --floatingand thefloatinginput ofcompozy__window_openask for a floating window explicitly. - Window › Arrange offers Main and stack, Columns, Grid, and Balance sizes, and Window › Move
window to sends a window to another desktop by name.
compozy layout arrangeand thecompozy__layout_arrangetool accept the newmain_stackarrangement, and an optional--keep-frames/keep_framesthat arranges each named tab deck whole. Without it, every named window is still its own participant. - Tabs look and behave like browser tabs, and window controls are quiet icons at the end of the head.
- An empty desktop asks "What should we work on?" above the session composer. Type a prompt and press Enter to start a session right there, with your project's default agent already picked.
- Sessions use the full width of their window again, tool calls read as quiet rows, and the list of sessions is open by default.
- Choose Light, Dark, or System in Settings › Appearance, or flip the theme from the dock. Dark stays the default. The choice is saved in this browser and applied before the first frame, and the terminal follows it.
- The interface uses Inter for text and Geist Mono for code, with higher-contrast secondary text in both themes.
Migration
Three [window_manager] defaults change. Your saved layouts, profiles, and any value you set
explicitly in config.toml are kept as they are; only unset values pick up the new defaults.
| Setting | Old default | New default |
|---|---|---|
gaps.inner / top / right / bottom / left | 8 / 8 / 10 / 8 / 10 | 0 |
new_window_policy | floating | tab |
bindings.bottom_center | reserved | zoom |
new_window_policy now accepts tab (the new default) and beside_focus (tile new windows beside
the focused one) alongside floating. To keep the previous behavior, set the old values explicitly:
[window_manager]
new_window_policy = "floating"
[window_manager.gaps]
inner = 8
top = 8
right = 10
bottom = 8
left = 10
[window_manager.bindings]
bottom_center = "reserved"
Or apply them from the CLI, for example
compozy config set window_manager.new_window_policy floating. Changes apply live. The theme is a
per-browser preference, not a config.toml key, so there is nothing to migrate for it.
- #681refactor: retire Network, managed Sandbox, and Bridges
- #683feat: calmer, plain-language web UI for everyday users
- #684feat: continue and fork sessions across agents, with fallback account routes
- #687feat: shell rail v2 with light and dark themes
- #685fix: wake creator on child turn completion
- #686fix: resolve reported runtime, catalog and delivery failures
30 files published by the GitHub release workflow.
Browse downloads
- checksums.txt2.7 KB · 83 downloads
- checksums.txt.sigstore.json10 KB · 74 downloads
- compat.json70 B · 21 downloads
- compozy-0.3.0-beta.29.tar.gz160 MB · 2 downloads
- compozy-0.3.0-beta.29.tar.gz.sbom.json794 KB · 2 downloads
- compozy-0.3.0.beta.29-1.aarch64.rpm43 MB · 3 downloads
- compozy-0.3.0.beta.29-1.aarch64.rpm.sbom.json2.9 KB · 1 downloads
- compozy-0.3.0.beta.29-1.x86_64.rpm47 MB · 3 downloads
- compozy-0.3.0.beta.29-1.x86_64.rpm.sbom.json2.8 KB · 2 downloads
- CompozyOS-0.3.0-beta.29-linux-x64.AppImage193 MB · 5 downloads
- CompozyOS-0.3.0-beta.29-linux-x64.deb168 MB · 14 downloads
- CompozyOS-0.3.0-beta.29-mac-arm64.dmg197 MB · 11 downloads
- CompozyOS-0.3.0-beta.29-mac-arm64.zip196 MB · 5 downloads
- CompozyOS-0.3.0-beta.29-mac-x64.dmg206 MB · 3 downloads
- CompozyOS-0.3.0-beta.29-mac-x64.zip205 MB · 3 downloads
- compozy_0.3.0.beta.29_amd64.deb47 MB · 4 downloads
- compozy_0.3.0.beta.29_amd64.deb.sbom.json2.6 KB · 1 downloads
- compozy_0.3.0.beta.29_arm64.deb43 MB · 3 downloads
- compozy_0.3.0.beta.29_arm64.deb.sbom.json2.6 KB · 1 downloads
- compozy_darwin_arm64.tar.gz45 MB · 27 downloads
- compozy_darwin_arm64.tar.gz.sbom.json294 KB · 1 downloads
- compozy_darwin_x86_64.tar.gz47 MB · 5 downloads
- compozy_darwin_x86_64.tar.gz.sbom.json294 KB · 1 downloads
- compozy_linux_arm64.tar.gz43 MB · 19 downloads
- compozy_linux_arm64.tar.gz.sbom.json298 KB · 1 downloads
- compozy_linux_x86_64.tar.gz47 MB · 78 downloads
- compozy_linux_x86_64.tar.gz.sbom.json298 KB · 1 downloads
- compozy_windows_x86_64.zip47 MB · 8 downloads
- compozy_windows_x86_64.zip.sbom.json304 KB · 1 downloads
- install.sh8.0 KB · 5 downloads
- Source code (tar.gz)
- Source code (zip)