Release detail

Soup 0.4.0

An optional workspace AI module that reads your notes, drafts staged changes you review hunk by hunk, runs scoped tools, reads notes aloud, and can run entirely against a local Ollama server.

Overview

0.4.0 adds an opt in workspace AI module. It is off by default. When you turn it on you choose how it talks to a model: a hosted provider with a paid tier, or a local Ollama server on the loopback interface that never leaves the machine.

Every change the assistant proposes lands as staged hunks first. Nothing is written to disk until you accept it. The same applies to file reads, terminal commands and web fetches: they go through a tool dispatcher with a per session allowlist, per tool rate limits and an explicit approval modal.

Highlights

  • Streaming chat in a workspace rail with thread history persisted under .soup/ai/threads/.
  • Multi note and multi file edit tools that stage changes hunk by hunk, with apply selected, apply all and reject controls.
  • Local AI index under .soup/ai/index/ covering markdown headings and tree sitter symbols across the most common languages.
  • Indexed at mentions in the composer with debounced re index on save.
  • Agent tool dispatcher honouring .soupignore, with size limits, per tool rate limits and an approval modal for sensitive actions.
  • Read aloud for notes with a content hash audio cache, cancellation, voice picker and rate slider, in whole note, paragraph or selection modes.
  • Inspect view that lists every outbound request with redaction summaries, byte counts and request timing.
  • Local only provider mode that uses a loopback Ollama server for chat, agent tools and embeddings without any sign in or cloud calls.
  • Tier aware model and voice gating with a paid Heavy chat model and long form read aloud voices.
  • Subscription checkout and customer portal flows for upgrades and cancellation.

AI module

  • Optional fifth workspace module. Off by default and gated by per workspace settings.
  • Right side AI rail with threads, composer, attachments, status strip, inspect view and offline state.
  • Streaming chat with abort, thread history persisted under .soup/ai/threads/, and per turn redaction summaries.
  • Bottom panel AI changes mode rendering staged hunks as read only diffs with apply selected, apply all and reject controls.

Tools and editing

  • Multi note and multi file edit tools that stage changes into .soup/ai/staged/ with per hunk accept and reject.
  • Wikilink and language server grounded context expansion when attaching a path or selection.
  • Many file diff grouping in the staged changes view.
  • Agent tool dispatcher with size limits, .soupignore enforcement, per tool rate limits and an approval modal.
  • Disabled by default terminal tool that runs only after explicit per command approval and only inside the workspace root.

Local index and at mentions

  • Local AI index built under .soup/ai/index/ with markdown heading and tree sitter symbol chunks.
  • Cosine search over batched embeddings with provider, model and dimension checks so a stale index cannot be searched silently.
  • Indexed at mentions in the composer with debounced re index on save.

Read aloud

  • Read aloud for markdown notes with whole note, paragraph and selection modes.
  • Content hash audio cache, voice picker, rate slider and cancellation.
  • Cache sweeping by max size and max age.

Local only provider

  • Loopback Ollama client used for chat, agent tools and embeddings when the provider is set to local only.
  • Cloud only paths (web fetch, read aloud, billing and usage refresh) are disabled and hidden in local only mode.
  • Settings panel for cloud or local Ollama, base URL, models, test connection and refresh models.

Account, billing and tiers

  • Device code login with a per device token bound to the install id hash.
  • Subscription checkout and customer portal flows for upgrades and cancellation.
  • Tier aware quota caps, paid only Heavy chat model and tier aware long form read aloud voices.
  • Free tier upgrade hint surfaced on quota exhaustion.

Privacy and safety

  • Pre send credential redaction across system prompts, user content and tool result content. Detects access keys, GitHub PATs, OpenAI keys, Google API keys, JWTs, RSA and EC private key blocks and high entropy assignments.
  • Per session path allowlist with reasons (editor open, rail attach, mention, tool approval). Tools refuse paths outside the workspace and reject existing symlink escapes.
  • Inspect view with bytes out, bytes in, status code and duration backfilled when a stream completes.

Quality

  • Rust workspace lints clean with warnings denied across all targets.
  • Rust workspace test suite all green.
  • Frontend typecheck, lint and tests all green.
  • Dependency audits clean: no known vulnerabilities at the time of release.
Version0.4.0
StatusRelease status: Preview
Published9 May 2026
Planned platforms10

Not yet available

10 builds

Windows

Windows NSIS installer

Pending
Format
EXE
Architecture
x64
File
Soup_0.4.0_x64-setup.exe
Size
Pending
Exact size
Pending
SHA-256
Pending

Windows installer will appear here once code signing is configured.

Soup_0.4.0_x64-setup.exe | Pending | sha256:pending
Coming soon

Windows

Windows MSI installer

Pending
Format
MSI
Architecture
x64
File
Soup_0.4.0_x64_en-US.msi
Size
Pending
Exact size
Pending
SHA-256
Pending

MSI installer for managed Windows installs. Will appear here once code signing is configured.

Soup_0.4.0_x64_en-US.msi | Pending | sha256:pending
Coming soon

macOS

macOS Intel DMG

Pending
Format
DMG
Architecture
x64
File
Soup_0.4.0_x64.dmg
Size
Pending
Exact size
Pending
SHA-256
Pending

Intel macOS packaging will appear here once code signing is configured.

Soup_0.4.0_x64.dmg | Pending | sha256:pending
Coming soon

macOS

macOS Apple Silicon DMG

Pending
Format
DMG
Architecture
ARM64
File
Soup_0.4.0_aarch64.dmg
Size
Pending
Exact size
Pending
SHA-256
Pending

Apple Silicon packaging will appear here once code signing is configured.

Soup_0.4.0_aarch64.dmg | Pending | sha256:pending
Coming soon

Linux

Linux AppImage (x64)

Pending
Format
AppImage
Architecture
x64
File
Soup_0.4.0_amd64.AppImage
Size
Pending
Exact size
Pending
SHA-256
Pending

Build artefacts for this release are pending the next available CI window. When they ship, this entry will update with download links and checksums.

Soup_0.4.0_amd64.AppImage | Pending | sha256:pending
Coming soon

Linux

Linux Debian package (x64)

Pending
Format
DEB
Architecture
x64
File
Soup_0.4.0_amd64.deb
Size
Pending
Exact size
Pending
SHA-256
Pending

Build artefacts for this release are pending the next available CI window. When they ship, this entry will update with download links and checksums.

Soup_0.4.0_amd64.deb | Pending | sha256:pending
Coming soon

Linux

Linux RPM package (x64)

Pending
Format
RPM
Architecture
x64
File
Soup-0.4.0-1.x86_64.rpm
Size
Pending
Exact size
Pending
SHA-256
Pending

Build artefacts for this release are pending the next available CI window. When they ship, this entry will update with download links and checksums.

Soup-0.4.0-1.x86_64.rpm | Pending | sha256:pending
Coming soon

Linux

Linux AppImage (arm64)

Pending
Format
AppImage
Architecture
ARM64
File
Soup_0.4.0_aarch64.AppImage
Size
Pending
Exact size
Pending
SHA-256
Pending

Build artefacts for this release are pending the next available CI window. When they ship, this entry will update with download links and checksums.

Soup_0.4.0_aarch64.AppImage | Pending | sha256:pending
Coming soon

Linux

Linux Debian package (arm64)

Pending
Format
DEB
Architecture
ARM64
File
Soup_0.4.0_arm64.deb
Size
Pending
Exact size
Pending
SHA-256
Pending

Build artefacts for this release are pending the next available CI window. When they ship, this entry will update with download links and checksums.

Soup_0.4.0_arm64.deb | Pending | sha256:pending
Coming soon

Linux

Linux RPM package (arm64)

Pending
Format
RPM
Architecture
ARM64
File
Soup-0.4.0-1.aarch64.rpm
Size
Pending
Exact size
Pending
SHA-256
Pending

Build artefacts for this release are pending the next available CI window. When they ship, this entry will update with download links and checksums.

Soup-0.4.0-1.aarch64.rpm | Pending | sha256:pending
Coming soon