Skip to content

Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.

docs(packaging): record the Linux build proof against the two-executable spec

rubenluetke10-beepacdd12963a67
diff --git a/docs/os-parity.md b/docs/os-parity.md
index ea1ae3cad4..5c8a6895f1 100644
--- a/docs/os-parity.md
+++ b/docs/os-parity.md
@@ -271,7 +271,7 @@ verifies against before it replaces anything.
|---|---|---|---|---|---|---|
| Windows 10/11 x64 | `PersonalJarvis-Setup-x64.exe` (Inno Setup, per-user, no admin prompt, fixed AppId for in-place upgrades) | `packaging/windows/build.ps1` | Yes — WebView2, the shipping desktop window | Owned by the Windows packaging work; see `packaging/windows/` | The installer creates and removes the Start-Menu / Desktop entries | Owned by the Windows packaging work — not verified from here |
| macOS 12+, arm64 and x64 | `PersonalJarvis-macOS-arm64.dmg`, `PersonalJarvis-macOS-x64.dmg` (`Personal Jarvis.app` + an `/Applications` symlink) | `packaging/macos/build.sh` | Yes — WKWebView through pywebview | Developer ID + Hardened Runtime + notarization when `APPLE_SIGNING_IDENTITY`/`APPLE_ID`/`APPLE_TEAM_ID`/`APPLE_APP_SPECIFIC_PASSWORD` are set; ad-hoc signing and a printed "right-click > Open" notice otherwise | The user drags the app to `/Applications`; the app registers nothing | **No real run yet.** `bash -n`, ShellCheck 0.11.0 `-S style` (zero findings) and a full `DRY_RUN=1` rehearsal of both the signed and unsigned paths. A macOS runner or a physical Mac is the outstanding gate |
-| Linux x86_64 | `PersonalJarvis-Linux-x86_64.AppImage`, `personal-jarvis_<version>_amd64.deb` | `packaging/linux/build.sh` | **No** — serves its interface over loopback HTTP and opens the default browser (P-38) | None. AppImage has no signing story in this project; the release's SHA-256 sums are the integrity check | `.deb` installs a `.desktop` entry, the hicolor icon, `/usr/bin/jarvis` and `/usr/bin/personal-jarvis`. The AppImage carries its `.desktop` inside itself for AppImageLauncher/`appimaged` | Full build proven in a `python:3.12-bookworm` container on 2026-08-25: `appimagetool` digest check, `desktop-file-validate`, `--version` through the packaged AppImage and through `AppRun`, `AppRun serve` answering `/api/health` in ~3 s, and the browser hand-off calling the opener with the right URL. Not run on a real desktop distribution or with FUSE |
+| Linux x86_64 | `PersonalJarvis-Linux-x86_64.AppImage`, `personal-jarvis_<version>_amd64.deb` | `packaging/linux/build.sh` | **No** — serves its interface over loopback HTTP and opens the default browser (P-38) | None. AppImage has no signing story in this project; the release's SHA-256 sums are the integrity check | `.deb` installs a `.desktop` entry, the hicolor icon, `/usr/bin/jarvis` and `/usr/bin/personal-jarvis`. The AppImage carries its `.desktop` inside itself for AppImageLauncher/`appimaged` | Full build proven in a `python:3.12-bookworm` container on 2026-08-25 (~2 min, 156 MB AppImage + 172 MB `.deb`): `appimagetool` digest check, `desktop-file-validate`, both executables out of one freeze, `--version` through the packaged AppImage and through `AppRun`, `AppRun serve` answering `/api/health` in 1-3 s, and the browser hand-off calling the opener with the right URL. Not run on a real desktop distribution or with FUSE |
**Frozen builds register nothing themselves.** For a native install the
installer owns every shell artifact, so `jarvis/setup/desktop_integration.py`
diff --git a/packaging/linux/README.md b/packaging/linux/README.md
index 7866bacba5..86694fa75e 100644
--- a/packaging/linux/README.md
+++ b/packaging/linux/README.md
@@ -135,14 +135,19 @@ A `.deb` install updates through the package, not through the app.
## What has actually been tested
-Proven in a `python:3.12-bookworm` container on 2026-08-25, against a real
-156 MB AppImage built by this script:
+Proven in a `python:3.12-bookworm` container on 2026-08-25, against real
+artifacts built by this script (a 156 MB AppImage and a 172 MB `.deb`, whole
+build ~2 minutes):
* `appimagetool` digest check, AppDir assembly, `desktop-file-validate` passes
+* both executables come out of one freeze - `PersonalJarvis` (windowed) and
+ `jarvis` (console) - and `usr/bin/Jarvis` links to the windowed one
* `--version` through the packaged AppImage (`APPIMAGE_EXTRACT_AND_RUN=1`),
- through the extracted `AppRun`, and through `usr/bin/jarvis`
-* `AppRun serve` boots the backend and `/api/health` answers in ~3 s
-* the browser hand-off calls the opener with `http://127.0.0.1:47821`
+ through the extracted `AppRun`, through `usr/bin/Jarvis` and through
+ `usr/bin/jarvis`
+* `AppRun serve` boots the backend and `/api/health` answers in 1-3 s
+* the browser hand-off calls the opener with `http://127.0.0.1:47821`, and the
+ app's own degrade message is in the log next to it
* the Debian package's control file, symlinks and desktop entry
Not tested: a real FUSE-mounted run on a desktop distribution, and the app on a