v0.7.0-beta.1 — 🧪 Desktop app (experimental)

Experimental native desktop app — a real application window (not a browser tab) over the same engine as the CLI/web GUI. Built with the OS-native webview (no Electron). This is a pre-release for testing — please report how the window behaves on your OS. The stable CLI remains v0.6.0.

Run it

OS	Steps
Windows	Download …-windows-x64.zip, unzip, run dvalincode-gui-windows-x64.exe. Needs the WebView2 runtime (built into Win11; most Win10). SmartScreen may warn (unsigned) → More info → Run anyway.
macOS	Download …-macos-arm64.tar.gz (Apple Silicon) or -x64 (Intel), extract, open DvalinCode.app. Unsigned → right-click → Open, or xattr -dr com.apple.quarantine DvalinCode.app.
Linux	Extract the tarball, run the binary. Requires WebKitGTK (sudo apt install libwebkit2gtk-4.1-0, or your distro's equivalent). Least tested — cross-compiled; feedback especially welcome.

A window titled DvalinCode should open with the full UI. The agent core, sessions, config, and audit trail are identical to the CLI/web.

Known caveats (it's a beta)

• Unverified rendering in CI — the build pipeline has no GUI session, so the window couldn't be auto-tested. The underlying tech (webview-bun + bun --compile embedding libwebview) is verified on macOS; the window itself needs your eyes.
• Unsigned — Gatekeeper/SmartScreen will warn.
• Linux is the least certain target (its webview lib is cross-compiled); a per-OS CI build is the planned follow-up.

Verify downloads against SHA256SUMS-gui.txt.

What's Changed

• docs: prominent English · 中文 language toggle in both READMEs by @arthurpanhku in #23
• Add native desktop GUI app (webview-bun) — experimental, v0.7.0 by @arthurpanhku in #24

Full Changelog: v0.6.0...v0.7.0-beta.1

v0.6.0 — Terminal agent + `serve`

⭐ Highlights

• 🖥️ Terminal agent — run dvalincode bare for an interactive terminal coding agent, Claude-Code-style: streaming responses, inline [y/N] write approvals with red/green diffs, /mode · /clear · /git · /plan · /compact · /undo · /help, Ctrl-C to interrupt, and a guided first-run provider setup. Defaults to read-only Chat, switchable live via /mode.
• 🌐 dvalincode serve — the web GUI now lives behind a command, so the same binary deploys headless on a server: dvalincode serve --host 0.0.0.0 --no-open.
• 🧩 One engine, two frontends — the terminal UI and web GUI both drive a shared, transport-agnostic turn-runner (src/agent/session.ts), keeping them at feature parity.

📦 Install

macOS / Linux one-liner:

curl -fsSL https://raw.githubusercontent.com/arthurpanhku/dvalincode/main/scripts/install.sh | bash

Then dvalincode for the terminal agent, or dvalincode serve for the web GUI. Or download a binary below and verify with shasum -a 256 -c SHA256SUMS.txt.

Platform	Asset
macOS Apple Silicon	dvalincode-v0.6.0-macos-arm64.tar.gz
macOS Intel	dvalincode-v0.6.0-macos-x64.tar.gz
Linux ARM64	dvalincode-v0.6.0-linux-arm64.tar.gz
Linux x64	dvalincode-v0.6.0-linux-x64.tar.gz
Windows x64	dvalincode-v0.6.0-windows-x64.zip

Full changelog: v0.5.0...v0.6.0

What's Changed

• Add terminal agent (TUI) and serve command on a shared turn-runner by @arthurpanhku in #21
• Release v0.6.0 by @arthurpanhku in #22

Full Changelog: v0.5.0...v0.6.0

v0.5.0

What's Changed

• Move mode, workspace, and model controls into composer dropdowns by @arthurpanhku in #18
• Plan v0.5: security differentiation (audit trail + enforced policy engine) by @arthurpanhku in #20
• Refresh README screenshots for the composer-dropdown UI by @arthurpanhku in #19

Full Changelog: v0.4.3...v0.5.0

DvalinCode v0.4.3 — Code permission docs and defaults

DvalinCode v0.4.3

This release documents and verifies the Code permission modes and workspace flows.

• README now explains the four Code permission modes: Ask Permissions, Plan Mode, Auto Mode, and Bypass permissions.
• README now documents folder selection, Git project import, and worktree support for Cowork/Code workflows.
• Fixed backend defaults so Code Ask Permissions requests approval before writes/commands when the frontend does not send an explicit approval mode.
• Kept Plan Mode read-only by default, while Auto Mode and Bypass permissions keep their expected behavior.
• Built from a clean v0.4.3 tag with packaged web assets beside each binary.

Verification:

• npm run check passed: 10 test files, 56 tests.
• npm run build:release passed.
• shasum -a 256 -c SHA256SUMS.txt passed for all release artifacts.

DvalinCode v0.4.2 — Windows binary asset path fix

Bugfix release for Windows binary startup.

Fixes #17.

Highlights:

• Fixed Windows Bun compiled binary detection for the virtual ~BUN source path.
• Windows now resolves the bundled frontend from the extracted executable directory (web/dist) instead of B:~BUN\root\web\dist.
• Rebuilt all release archives from the patched source.
• macOS archives continue to include a DvalinCode.app launcher with the project logo as the app icon.

Note: Bun currently only supports Windows exe icon/metadata injection when compiling on Windows, so the cross-compiled Windows artifact is rebuilt but does not include an embedded exe icon.

Verification:

• npm run check: 10 test files, 56 tests passed.
• SHA256SUMS.txt verified locally before upload.

Full Changelog: v0.4.1...v0.4.2

DvalinCode v0.4.1 — Local server hardening

Bugfix release for the local GUI binary.\n\nHighlights:\n- Hardened the local server boundary: loopback binding, browser origin checks, and workspace-root validation for WebSocket/REST cwd inputs.\n- Safer @file expansion using realpath workspace checks and .dvalincodeignore.\n- Release archives rebuilt from the patched source.\n- macOS archives now include a DvalinCode.app launcher with the project logo as the app icon, while keeping the original CLI binary for the installer.\n\nNote: Bun currently only supports Windows exe icon/metadata injection when compiling on Windows, so the cross-compiled Windows artifact is rebuilt but does not include an embedded exe icon.\n\nVerification:\n- npm run check: 10 test files, 56 tests passed.\n- SHA256SUMS.txt verified locally before upload.

v0.4.0

What's Changed

• docs: polish README — What's New, FAQ, provider pricing, more badges by @arthurpanhku in #7
• docs: README core goal + 2026-06 release intel, requirements & dev plans by @arthurpanhku in #8
• feat: add official logo to README by @arthurpanhku in #9
• Docs/core goal and release intel by @arthurpanhku in #10
• feat(requirements): Gemini analysis → /compact plan + dvalin.json tea… by @arthurpanhku in #11

Full Changelog: v0.3.0...v0.4.0

DvalinCode v0.3.0 — Mode-aware Sidebar

DvalinCode v0.3.0

Three distinct sidebar experiences, a marketing-grade README with embedded GIFs, and a one-line installer.

---

📦 Downloads

Platform	File
macOS Apple Silicon (M1/M2/M3)	dvalincode-v0.3.0-macos-arm64.tar.gz
macOS Intel	dvalincode-v0.3.0-macos-x64.tar.gz
Windows x64	dvalincode-v0.3.0-windows-x64.zip
Linux ARM64	dvalincode-v0.3.0-linux-arm64.tar.gz
Linux x64	dvalincode-v0.3.0-linux-x64.tar.gz

---

🚀 Quick Install

macOS / Linux — one-line installer (NEW in v0.3.0):

curl -fsSL https://raw.githubusercontent.com/arthurpanhku/dvalincode/main/scripts/install.sh | bash

Auto-detects OS + arch, downloads the right archive, installs to ~/.dvalincode/, and adds it to your PATH.

Windows: Unzip dvalincode-v0.3.0-windows-x64.zip and run start.bat.

Manual: Untar/unzip and run start.sh (or the binary directly).

---

✨ What's New in v0.3.0

Mode-aware sidebar — three distinct experiences

Inspired by Claude's separate Chat / Projects / Artifacts panels, the sidebar now changes completely based on the active mode:

• 🗨️ Chat — Templates section with five one-click prompts (Explain codebase, Find TODOs, Review changes, Write tests, Refactor suggestion). Click to send.
• 👥 Cowork — Projects / All tasks toggle. Projects view groups sessions by cwd directory into an expandable folder tree.
• ⚡ Code — Routines section: five default quick-fire commands (Run tests, Type check, Build, Git status, Lint). Add custom routines that persist in localStorage.

Marketing-grade README

• Hero banner + badges (Release / License / Platforms / 中文 switcher)
• Six-row feature table (Chat / Cowork / Code / GUI / Zero-deps / Local-first)
• Embedded GIF previews of mode switching and slash/@ dropdowns
• Full feature matrix + slash command reference + architecture diagram
• README.zh-CN.md — full Chinese parity

One-line installer (scripts/install.sh)

• Auto-detects macOS / Linux × arm64 / x64
• Fetches latest release tag from GitHub API
• Downloads → extracts → patches ~/.zshrc / ~/.bashrc with PATH update
• DVALINCODE_VERSION env var pins to a specific version

GIF capture pipeline (scripts/capture-gifs.mjs)

• Playwright headless drives the local Vite preview
• ffmpeg palettegen + paletteuse produces optimized GIFs (~100KB each)
• Re-run the script after UI changes to refresh README previews

---

Already in v0.2.0 (for newcomers)

Mode	Tool access	Approval policy
Chat	Read-only (read_file / list_files / search_text)	n/a — nothing writes
Cowork	All tools	Each write / shell call requires explicit approval (with inline diff)
Code	All tools	Full-auto

Plus: @ file references, / slash commands, inline diff viewer, syntax highlighting, Git awareness, AGENTS.md project memory, LLM-based context compaction, /undo, macOS shell sandbox, multi-profile config, .dvalincodeignore, real-time token + cost counter.

---

Verify checksums: SHA256SUMS.txt is included.

DvalinCode v0.2.0 — Web GUI

DvalinCode v0.2.0 — Web GUI Release

A full-featured AI coding assistant with a built-in browser UI. Start the binary and the GUI opens automatically in your browser.

---

📦 Downloads

Platform	File	Notes
macOS Apple Silicon	dvalincode-v0.2.0-macos-arm64.tar.gz	M1/M2/M3 Mac
macOS Intel	dvalincode-v0.2.0-macos-x64.tar.gz	Intel Mac
Windows x64	dvalincode-v0.2.0-windows-x64.zip	Windows 10/11
Linux ARM64	dvalincode-v0.2.0-linux-arm64.tar.gz	Raspberry Pi, ARM servers
Linux x64	dvalincode-v0.2.0-linux-x64.tar.gz	Standard Linux

---

🚀 Quick Start

macOS / Linux:

tar xzf dvalincode-v0.2.0-macos-arm64.tar.gz
cd dvalincode-macos-arm64
./start.sh          # or ./dvalincode-macos-arm64 directly

Windows:

Unzip dvalincode-v0.2.0-windows-x64.zip
Run start.bat       # or dvalincode-windows-x64.exe directly

The server starts on http://localhost:3000 and opens your browser automatically.

First run: click LLM Configuration in the sidebar to set your API key (DeepSeek, OpenAI, Groq, OpenRouter, or Ollama).

---

✨ What's New in v0.2.0

Chat / Cowork / Code modes — Three distinct operating modes with different tool access and sidebar layouts:

• Chat: Templates panel (Explain codebase, Find TODOs, Review changes…)
• Cowork: Projects tree (sessions grouped by workspace) + plan-first execution
• Code: Routines panel (one-click commands: Run tests, Type check, Build…)

17 features shipped across 4 sprints:

• Diff Viewer — red/green diffs in tool results
• @ file references — type @ to insert file contents
• Syntax highlighting — code blocks with language colours
• Git awareness — branch display + git_status tool
• AGENTS.md — per-project persistent instructions
• Slash commands — /clear /compact /git /plan /undo /help
• Token cost estimation — real-time USD cost per session
• Plan mode — Cowork auto-detects numbered plans and renders PlanCard
• Approval dialog with diff — edit_file shows inline diff before approval
• LLM-based context compaction — /compact summarises via LLM
• /undo — reverses the last N tool calls
• Shell sandbox — macOS sandbox-exec (deny network, write to cwd only)
• Multi-profile config — save/apply named LLM profiles
• .dvalincodeignore — exclude sensitive files from agent access
• Task progress tracking — live tool-call counter in topbar

---

Verify checksums: SHA256SUMS.txt is included in the release.