Johan LEROY
a7e04278fd
« Démarrer le projet » : un repo définit une fois ses commandes de démarrage (serveur de dev, API, base de données), un clic ouvre un terminal PTY par commande dans le dock IDE. Serveur (additif, PROTOCOL_VERSION inchangé) : - LaunchCommand[] persistées sur repos.launch_commands (migration 13) ; champ additif SessionSummary.launchRunId. - POST /repos/:id/launch : résolution du worktree côté serveur, cwd de commande borné (anti-traversal), commandIds outrepasse enabled. - GET /repos/:id/launch/detect : détection package.json / Procfile / docker-compose. - Shell de login interactif ($SHELL -l -i, charge le PATH nvm/asdf) + auto-type de la commande ; le shell survit à la commande (échec visible). Web : LaunchProjectModal + actions (ProjectTreeNode, SessionsPanel, CommandPalette), stores sessions/worktrees, i18n EN/FR. Alignement du reste du projet : - Extension VS Code 0.4.0 : commande Start Project (repo/worktree), Stop Launch, badge « launch » dans l'arbre, méthode REST startLaunch. - Site vitrine : 16e feature card (Rocket) + section showcase « Start the project » (mockup fidèle au modal), i18n EN/FR. - Documentation : README (EN + FR), help-content (EN + FR), CHANGELOGs server + vscode. Vérifié : 430 tests, typecheck, build (web + site + vscode), acceptance-p13 ALL GREEN, VSIX packagé, garde anti-tirets, vérif visuelle du site (thèmes clair et sombre).
Arboretum Desktop
Native desktop shell (Electron) for Arboretum. It runs the existing daemon as a child process and shows its web UI in a window, already authenticated (no login screen). The heavy lifting stays in the daemon; this package is a thin shell (window lifecycle, daemon supervision, auto auth).
This package is intentionally outside the root npm workspaces so the daemon CI stays light. It
has its own package-lock.json and is built on a developer machine (or a dedicated CI runner),
not by the main npm run build.
How it works
- The shell picks a data directory under the OS user-data path and spawns the bundled Node runtime
running the packaged daemon (
build/server/package/dist/index.js) withARBORETUM_EMIT_TOKEN_FD=3. - The daemon mints a fresh token and writes
{token, url}on file descriptor 3 (private stdio pipe). - The shell posts that token to
/api/v1/auth/loginfrom the window's session (server to server), which drops thearb_sessioncookie into the session jar, then loads the SPA on127.0.0.1. - On quit, the daemon child gets
SIGTERM(thenSIGKILLafter a grace delay).
A standalone Node runtime (pinned, >= 22.16) is bundled instead of reusing Electron's Node, so
node:sqlite works without a flag and the node-pty prebuild keeps the node. ABI prefix.
Prerequisites (all platforms)
- Node >= 22.16 to build.
giton PATH at runtime (worktree operations).claudeis discovered on PATH or via the in-app Claude CLI setting; it is not bundled.
Develop
cd packages/desktop
npm install # ELECTRON_SKIP_BINARY_DOWNLOAD=1 to skip the Electron binary if you only typecheck
npm run dev # bundles main/preload, then `electron .` against the repo's built daemon
npm run dev runs the daemon from the repo (packages/server/dist, so run npm run build at the
repo root first) using the system node.
Build installers
Each command builds the shell, prepares the daemon (npm pack + runtime deps with the right
node-pty prebuild) and a standalone Node runtime, then runs electron-builder.
npm run dist:linux # AppImage + .deb (on Linux)
npm run dist:win # NSIS + portable (on Windows)
npm run dist:mac # dmg + zip (on macOS)
Artifacts land in packages/desktop/release/.
Linux
Fully supported. dist:linux runs on a Linux host or the Gitea CI runner.
Windows
Build on a Windows host (recommended): the node-pty win32 native binary and the installer
(makensis) are most reliable there. Cross-building from Linux via Wine is a best-effort fallback.
The app uses ConPTY (Windows 10 1809+). The installer is not code-signed yet, so SmartScreen shows
"unknown publisher": choose "More info" then "Run anyway".
macOS (best-effort)
Build on a Mac (dmg/zip cannot be produced elsewhere). The app is not signed or notarized,
so Gatekeeper blocks the first launch: right-click the app then "Open", or run
xattr -dr com.apple.quarantine /Applications/Arboretum.app.
Auto-update
electron-builder emits latest*.yml next to the artifacts; electron-updater (wired in a later
change) points at the Gitea release assets. Auto-update works for Windows (NSIS) and Linux
(AppImage); macOS updates are manual while the app is unsigned.
Icon
resources/icon.png (square, >= 512px) is the single source; electron-builder derives every
platform icon from it.