Skip to content
GitHub Download

Changelog

What changed in each HeadlessOS release, from new features and security work to bug fixes.

Every HeadlessOS release, newest first. Download the latest version, or see all the files on GitHub Releases.

0.3.1 wasn’t published, so its changes are here too.

  • The log records problems, not what you do. It used to write a line for every request, naming the files, containers and services you opened, and a failed connection wrote the server’s address. It now records failures only, with no requests, commands, addresses or logins. Logs from older versions are removed the first time this version starts.
  • The launcher leaves your desktop showing. It’s shorter, and it keeps clear of the top bar. Its apps sit on the same colour tiles as the dock and follow the Dock Icons setting, and the quick actions are smaller tiles with their names. In a short window it shows a scrollbar, and searching no longer changes its height.
  • On a Mac, HeadlessOS uses San Francisco, like the rest of the system. Windows and Linux keep Manrope.
  • About HeadlessOS, Settings → About and the wallpaper show the app’s real logo.
  • The About HeadlessOS window cut off its description.
  • --user-data-dir moved only part of the app’s data, because 0.3.0 pinned the data folder.
  • The key to your saved logins is in the OS keychain. It was a plain file beside the logins, so a copy of the folder, or a program you were tricked into installing, could read them. A copy of the folder no longer opens on its own, on any platform with a keychain. On a Mac, other apps are kept out too: macOS asks, naming the app. Windows and Linux can’t stop a program running as you .
  • On a Mac, HeadlessOS says why before macOS asks for your Keychain password. Because the app isn’t signed yet, this can happen once after each update.
  • If saved logins can’t be opened, the sign-in screen says they’re locked and what to do. Global Settings shows where the key is held.
  • A saved login that couldn’t be opened was dropped at the next save. It’s now kept.
  • A log file. The desktop app writes ~/.headlessos/logs/headlessos.log, with passwords, keys and tokens masked. It stays on your computer. Open it from Global Settings, Settings → About, or Help → Open Logs.
  • Help at the top of Control Center: Documentation, Troubleshooting, Open log and Report an issue, before you’ve signed in to anything.
  • Linux builds: every release now has an AppImage and a .deb.
  • Changes can’t skip your approval. A widget’s refresh command could be written by a model and ran on a timer with no click, so a view could stop a service or remove a container without asking. Refreshes and view buttons now only run commands that read. find can no longer delete or write files, and output can’t be redirected to a file.
  • SSH keys are encrypted. Private keys and passphrases sat in servers.json in plain text, and the server list sent them to the window. They’re now encrypted like passwords, including ones you’ve already saved, and stay in the backend.
  • Secrets stay out of the parsing fallback. Output sent to a model for parsing now has secrets removed first, as agent runs already did.
  • A maximized window now takes the full height. The dock slides away, and comes back when you hover the handle at the screen’s edge, click it, or click Show launcher in the top bar.
  • If the backend stops while the app is running, the app says so and offers Restart, Open Log and Quit, instead of every window quietly failing. If it stops during startup, the app says so at once instead of waiting 20 seconds.
  • “Failed to fetch” now tells you the app can’t reach its own backend and that nothing was sent to your server.
  • On a Mac, a connection to a device on your local network could fail while ssh from Terminal worked, because macOS keeps apps off the local network until you allow them. The app now says why it needs access, and the error says where to allow it.
  • Help → Documentation and Report Issue opened a GitHub page that doesn’t exist.
  • The sign-in screen said “Connection failed. Check server credentials.” for every failure. It now says what happened and what to try, shows the exact error to copy, and links to the fix and the log.
  • A wrong password was tried four times, which could trip fail2ban and lock you out. It’s now tried once.
  • If a saved password couldn’t be decrypted, the whole server list was lost on the next save. Your servers now stay, and you sign in again.
  • Saved passwords, SSH keys and AI keys depended on the computer’s name, so renaming it could make them unreadable, and a Mac can pick up a new name from the network. They no longer do, and existing ones move over at the next start.
  • A server whose saved key can’t be read said “SSH key configured”, then “The server refused this login”. It now says the key is gone and what to do.
  • A damaged server list looked like a new install. The screen now says so and names the kept file .
  • In the installed app, windows, panels and the top bar had no blur, so the desktop showed through them. They now match the browser.
  • Claude as a model provider. Choose Claude Haiku 5.5, Sonnet 5.5 or Opus 5.5 in Settings → AI, next to OpenAI and Ollama. The key is checked with Anthropic before it is saved, and stored encrypted.
  • Local models through Ollama. Pick an installed model, and HeadlessOS sizes every request to the model’s real context window.
  • Safe agents:
    • Agents call typed actions from a fixed catalog instead of writing shell commands.
    • Anything that changes a server waits for your approval and is written to an audit log.
    • Secrets are removed from server output before a model sees it.
  • The UI Agent builds views widget by widget, with values filled from what the server returned, not copied by the model.
    • Follow-up prompts refine the open view in the same window.
    • Unclear requests get a question back.
  • Agents that stay on track on small models. Context is compacted in layers, loops are caught and stopped, and broken or cut-off replies are asked for again.
  • Container files and shells. Browse, edit, upload and delete files inside a Docker container, and open a shell in it, all over SSH.
  • A new look: a glass desktop with dock, launcher, Quick Settings, notifications, a Home hub, a code editor in Files, and more in Task Manager (app history, startup apps, users, services).
  • Network traffic on the Home hub: the selected server’s download and upload for the last 1, 5 or 15 minutes, with peak, average and total, in place of the sample music card.
  • Docs: SECURITY.md and CONTRIBUTING.md; a README with install steps and screenshots.
  • An audit before open-sourcing (October 2026):
    • two command-injection paths closed;
    • every API and WebSocket call needs a per-install token;
    • Host and WebSocket-origin checks;
    • a per-install encryption secret.
  • No known high or critical advisories in production dependencies: fastify 5.12, zod 4, openai 6, dompurify 3.4.17. An unused static-file plugin was removed.
  • Backend refactored into domain services behind one command-policy chokepoint.
  • Apple and Microsoft wallpapers removed; MIT licence added.
  • Desktop builds no longer ship server code from git: the release build bundles it fresh. The release workflow runs the full typecheck and test suite first.
  • Open apps get a lane across the dock, brighter with an accent bar for the app in front, so a minimized app no longer looks switched off.
  • The Fleet overview matches the Home hub: a status light and dials for CPU, memory and disk on every server card, and one summary for the whole fleet. CPU is new to it.
  • The agent audit log could replace an older rotated file when two rotations fell in the same millisecond, losing entries.
  • Local-model runs no longer show a made-up cost.
  • When the HeadlessOS backend was down or restarting, the sign-in screen said “No servers configured yet”. It now says the list couldn’t load, retries every 3 s, and shows your servers once the backend answers.
  • File Explorer’s Home, Desktop, Documents and Downloads opened /home/testuser on every server. Home is now your own home folder, as the server reports it, and the others show only when they exist there.
  • The desktop app could not reach its own backend: its sandboxed preload failed to load, so the window never got the server’s port or token. v0.1.0’s builds have the same fault .
  • The desktop app had no wallpapers: they were never copied into the build.

First release: the desktop (Dashboard, Files, Terminal, Docker, Services, Task Manager, Server Admin), multi-server sessions with hibernation, the AI Agent, the UI Agent with Dynamic UI, and the LLM Observatory.