Repository navigation
Saturn v0.6.1
Pre-releaseSaturn is a workbench for AI research on your own computer: the app, its research assistant and its local runtime in one download.
Preview build. The macOS app is not signed with an Apple Developer ID (Apple Silicon only), and the Windows installer is signed with Saturn's self-signed certificate, which Windows does not trust, so both systems warn the first time you open them.
Install
macOS (Apple Silicon)
- Download
Saturn-0.6.1-mac-arm64-unsigned.dmg, open it, and drag Saturn into Applications (the.ziphas the same app). - Open Saturn. When macOS says it can't verify the developer, go to System Settings → Privacy & Security and click Open Anyway.
Windows (x64)
- Download
Saturn-0.6.1-win-x64-setup.exeand run it. - If SmartScreen stops it, click More info → Run anyway.
- Optional: confirm the installer is Saturn's. In PowerShell,
(Get-AuthenticodeSignature .\Saturn-0.6.1-win-x64-setup.exe).SignerCertificate.Thumbprintshould printD285DA425077C16A3D115D61F9748AFA574BC786.
Then open Settings → Models and connect a model, add a project folder, and write your first question (the first launch walks you through it). The interface is in English or Traditional Chinese, following the system or chosen in Settings → General.
Updating: from a version before the rewrite in Rust and Tauri (0.3.1 or earlier), install this one by hand; your data in ~/.saturn-app keeps working. Later versions update themselves: the update downloads in the background and installs when you quit Saturn, and it must carry a signature from Saturn's updater key.
Check a download (optional): each file has a .sha256 beside it, and a signed build attestation that proves it was built from this repository's source by its public release workflow:
shasum -a 256 -c Saturn-0.6.1-mac-arm64-unsigned.dmg.sha256
gh attestation verify Saturn-0.6.1-mac-arm64-unsigned.dmg -R Saturn-Technology-Project/Saturn-AppThe signed attestations are attached too (*.sigstore.json); with one, gh attestation verify <file> --bundle Saturn-0.6.1-mac-arm64.sigstore.json -R Saturn-Technology-Project/Saturn-App checks a macOS download offline (-win-x64.sigstore.json for Windows).
Saturn-0.6.1-sbom.cdx.json lists the crates, npm packages and model this release is built from (CycloneDX 1.5, with their hashes), for your scanner or your security team.
saturn-worker-0.6.1-linux-x64 and -linux-arm64 are the worker Saturn installs on a Linux SSH host when you press Install worker in Environment; you do not need to download them. Saturn checks each against the hash built into this release before sending it, and the host needs libssl 3 (Ubuntu 22.04, Debian 12, RHEL 9 or later).
Changes
What changed in each version, and whether it affects you, is in CHANGELOG.md.
What changed
Security
- A command an agent runs can no longer read Saturn's token or keys. The sandbox around shell commands limited only where they could write, so a command that matched no risky pattern, run without a card in the default mode, could read the runtime's token and both halves of the key store, send them anywhere, and use the token to turn its own sandbox off. Commands now can neither read nor write Saturn's data folder or the usual credential folders (
~/.ssh,~/.aws,~/.config/gh,.npmrcand the like). If a command of yours needs one of these, run it with the sandbox off, which asks first. - A project's instruction files and skills reach agents only once you allow them.
AGENTS.md,CLAUDE.md,.saturn/rules,.agents/rules,.cursorrulesand the project's skills went into every agent's prompt as instructions to follow, though a cloned repository brings them. They are now held until you read and allow that exact content: the research assistant shows a line with Review, and Settings → Projects has them too. Any change, an agent's own new rule included, asks again. The rules you save in Saturn always apply, and a project's skill can no longer replace one of Saturn's research skills by taking its name. - The project's Python, its environment jobs and its check command run in the sandbox. Saturn ran the project's interpreter (for the environment check, notebooks, looking inside a model, reading data and the language server), environment installs and the project's check command with your whole environment and no sandbox, so a cloned project's environment could run code with full access as soon as a Python file was opened. They now run in the project's command sandbox, the check command with PATH alone, and its output goes back to the agent marked as output. The assistant changing the project's interpreter asks first.
- The desktop app no longer hands its token to whatever listens on the runtime's port. While it waited for the runtime it sent the long-lived token with every health check, so a program of another user holding port 4700 could take it. The health check carries no token, each time the app opens the runtime gets a new one, the interface sends it only once the app has seen its own runtime answer, and no program Saturn starts inherits it.
- Fewer ways for an injected agent to act or persist without you. A file patch is judged by the files it touches, so a rule like
files: write secrets/**or a.claude/settings.jsonEdit(...)deny now stops it, and deleting a file asks; a rule allowing a shell or launcher with a wildcard (sh *,env *) is refused like*; commands that reach for Saturn's keys or a key store ask; a task delegated to another agent asks at least as much as the chat it came from; creating, enabling or running an automation asks; in Ask and Plan chats the web tool and the browser open only plain addresses, not one whose query or path could carry what the chat read; memory notes come only from what you typed; a model's source can no longer open Saturn's data to an experiment run. - Fewer places a secret can show. Claude Code no longer inherits other services' credentials from your environment (it keeps Anthropic's, and AWS and Google ones for Bedrock and Vertex); the network log leaves out a path segment long enough to be a token, as it already did the query string.
Fixed
- Signing in to an MCP server in the browser works. Connecting a remote server that needs a sign-in now opens its sign-in page, and the browser's return to Saturn finishes it; before, the return address did not exist, and such a server could only fail with "requires sign-in". The return finishes only a sign-in Saturn started, once. A server waiting for its sign-in has a Connect button.
- Windows: opening an address in the browser no longer goes through cmd, which would have read an
&in it as a second command. - The access dialog keeps its buttons inside it. A long folder path widened the dialog's content past its edge, so the note under it and Cancel and Allow Access sat over the window behind. The whole path now wraps inside the dialog, in that dialog and in Edit Workspace.
Changed
- The project list says where each project is, and adding one stands apart. The list at the top of the window shows each project's folder under its name, with the home folder written
~, and a line sets "Add a project folder…" off from the projects. The name is given the room it needs, up to a limit, instead of a fixed width that cut a long one short. - Group chats, prompt commands and the editor's completion routes are gone from the runtime. No screen has opened a group chat since 0.4.0, run a plugin's
/command or asked for an inline completion, so the routes behind them (/groups,/commands,/complete) and their code are removed; a script that called them now gets a 404. A plugin still installs with its skills, hooks and MCP servers, and Settings → Plugins no longer counts its commands. Groups and their messages from an earlier version stay instate.json. A group's turn that such a version left waiting for an approval or asleep is ended when Saturn starts, with the reason, instead of going on under the agent's own approval setting. Usage already recorded for completions still shows in the usage summary.
Added
- A computer without Python gets one from Saturn. When neither uv nor Python is found, Environment offers to download uv (about 15 MB, from its GitHub release, checked against a checksum pinned in Saturn, like the Claude Code and Codex downloads), and making the managed environment then has uv install a Python first, the version you chose or the newest stable, before the environment is made from it. A computer with Python but no uv is offered the same download, since uv is what lets a Python version be picked. Saturn's copy of uv can be removed like the other programs; the Python uv installed stays in uv's own folder.
What's Changed
- Programs: uv is downloaded, and a computer without Python gets one from it by @rickwengdev in #90
- Shell: the access dialog keeps its buttons, and the project list shows where each project is by @rickwengdev in #91
- Bump taiki-e/install-action from 2.88.1 to 2.89.1 in the actions group by @dependabot[bot] in #92
- Bump the desktop-minor-and-patch group in /desktop with 2 updates by @dependabot[bot] in #93
- Bump base64 from 0.22.1 to 0.23.1 by @dependabot[bot] in #94
- Bump macos-accessibility-client from 0.0.1 to 0.0.2 by @dependabot[bot] in #95
- Runtime: the unused sha1 dependency goes by @rickwengdev in #97
- Security: the audit's findings fixed — sandbox hides Saturn's keys, project instructions need approval, research Python is sandboxed by @rickwengdev in #98
- Runtime: the dead code left from the 8 November audit is removed by @rickwengdev in #99
- Release: 0.6.1 by @rickwengdev in #101
Full Changelog: v0.6.0...v0.6.1