Roadmap: Atlas end to end on Linux (stable core, native look, instant, crew-safe) — tracking
Maintainer antworten meist innerhalb von 1 Tag
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Anfängerfreundlichkeit
- 10/100
Rechercherichtung
This is an umbrella tracker, not a work item: pick one unchecked sub-issue (start with #265 or #266, which block the rest) and read it instead. For context, skim the desktop, hostd and packaging crates in the Rust/Tauri workspace plus the CI workflow that builds the release AppImage, and reproduce a first run on Linux before changing anything. Done for the tracker as a whole means a fresh install on Arch, Ubuntu 24.04 and Fedora opens with one title row, updates and uninstalls cleanly, and CI gates startup and idle numbers on every release.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Tracking issue: make Atlas on Linux as stable, fast and polished as on macOS, with Windows parity where the same code path applies. Source: hand test on Omarchy (Arch, Hyprland Wayland, AMD 680M, Mesa 26.2.5) of 1.5.0-alpha.25, plus a code study of desktop, CLI, hostd, packaging and CI. Labels: os: linux / os: windows / os: macos mark the platforms each item touches.
Status for 1.5.0-alpha.26 (the Crew release), updated 2026-11-15 late
Merged on main (each batch passed bun run check locally on the exact combined tree; GitHub CI runs once, all together, before the tag):
- 2026-11-15 early: #327 (#266 AppImage env and libwayland).
- Batch 1: #409 (#303), #326 (#265 PATH), #328 (#306), #347 (#273), #330 (#319), #415 (#414 security), #416, #410 (#300, #304), #413 (#301), #353 (#269), #417 (#305).
- Batch 2: #411 (#298, #299), #418 (#280, #281), #419 (#283, Linux part of #312), #421, #431, #423 (#270), #427 (#278), #429 (#307), #425 (#272).
In progress for .26:
| Item | Where |
|---|---|
| #274 reports keep app.log, stderr and the full environment | PR #432, local gate running |
#275 one diagnostics bundle (app + atlas doctor --bundle) |
branch feat/diagnostics-bundle |
| #276 hostd deaths as incidents | branch fix/hostd-death-incidents |
#265 last point: media playback (GStreamer appsrc) |
being reproduced on a private instance |
| Real crew server end to end (systemd + ssh, fake engine) | PR #424; found real bugs, being fixed |
Before tagging .26:
- The items above merged.
- Full CI on
maingreen on macOS, Linux and Windows (fix everything it finds in one pass). -
release.ymlbuild-only dispatch frommain: every build plusverify-linux(Arch, Fedora, Ubuntu 24.04, Debian) green. - Fold
## [Unreleased]into the1.5.0-alpha.26CHANGELOG section.
Deferred to .27 (none blocks a first user installing, opening and using Atlas or Crew): #267, #268, #271, #277 (package installs), #279, #282 (recording/mirror/Lab), #284–#288, #308–#310, #312 (Windows/macOS artifacts), #313, #315 (rest), #317, #318, #320–#322, #426.
Principles
- Linux ships nothing that no CI job has opened (the release AppImage aborted every web process on Arch: #265).
- Every Linux failure must explain itself: stderr captured, web-process deaths detected, one diagnostics bundle.
- One chrome model per platform that looks native: no stacked bars.
- Numbers before optimizations: startup and idle measured on Linux and gated in CI.
- Agents and contributors on Linux get the same isolated instance, screenshots and benches as on macOS.
Phase 0: it opens (blockers)
- #265 Linux first-run: PATH in every shell (#326, merged), desktop installed by install.sh and
atlas doctor(in .26), EGL blank window (#327, merged). Open: GStreamerappsrcwith real media not confirmed; container proof lands with #419. - #266 AppRun env and excluded libs (#327); proven on Arch/Fedora/Ubuntu/Debian containers by #419's
verify-linux. - #272 Dead web process: reload once, then a native dialog; 30 s ready timeout on every OS (#425).
- #273 WebKit/GTK stderr in
desktop/stderr.log, rotated, in Copy details (#347).
Phase 1: never ship broken again (CI + diagnostics)
- #283 "Desktop opens (Linux)" CI job; release artifacts opened in containers before publish (#419).
- #274 Reports keep app.log and the environment: PR #432. Done: #432, alpha.26.
- #275 One diagnostics bundle (
atlas doctor --bundle): in progress for .26. Done: #439, alpha.26. - #276 hostd deaths recorded as incidents: in progress for .26. Done: #438, alpha.26.
Phase 2: install, update, uninstall
- #267 Prefer the distro package over the AppImage; AUR; real runtime deps (.27; #419 already made
libayatana-appindicatora hard Arch dependency) Done: #469, onmain, ships in alpha.27. - #278 In-app Update for package installs: the command per package manager,
pkexecInstall now (#427). - #277
atlas uninstallleftovers and package installs (.27; PATH/link/fish cleanup done in #326) Done: #462, ships in alpha.27. - #279 Signed SHA256SUMS (.27)
- #268 arm64 Linux (.27) Done: #487, ships in alpha.27.
Phase 3: looks native
- #269 One title row on Linux, tiling WMs detected by their own variables (#353). Known limit: 5 px resize band at the window edge (tauri-runtime-wry).
- #270 Ctrl shortcut labels off macOS (#423).
- #271 Windows snap-layout flyout, optional Mica (.27)
Phase 4: instant and light (.27, after #283 gives the harness)
- #284 Linux baseline: cold start, RSS per process, idle CPU, gated in CI Done: #471, ships in alpha.27.
- #285 Login-shell probe runs 3 times at startup Done: #472, ships in alpha.27.
- #286 Two hidden webviews built on every Linux launch Done: #473, ships in alpha.27.
- #287
projects_listIO on the main thread on every focus #474, ships in alpha.27. - #288 Frontend entry-chunk budget Done: #481, ships in alpha.27.
- Terminal on Linux: #249 / #247 (native GPU terminal), #239 (add a Linux row), #254
Phase 5: agents and contributors on Linux
- #280 Isolated agent instances on a private headless sway + D-Bus (#418).
- #281 Agent instances skip single-instance; dev builds have their own id (#418).
- #282
debug shoton Linux in #418;record/ mirror / Lab remain (.27)record, mirror and Lab: #493, ships in alpha.27. - Windows contributor DX: #260
Order and dependencies
#265 + #266 unblock everything that launches the app (#283, #280, #284). #273 -> #275 -> #274. #280 -> #282. #266 -> #269 -> #270.
Done when
A fresh curl | sh on Arch, Ubuntu 24.04 and Fedora (GNOME, KDE, Hyprland; AMD, Intel, NVIDIA) installs, opens with one title row and no WebKit aborts, updates and uninstalls cleanly; CI proves the first two on every release; startup and idle numbers are published and gated.
Phase 6: core resilience (hostd, runtime, IPC)
- #298 IPC deadlines + liveness probe; a slow hostd is never killed (#411)
- #299 Event lag: coalesced resync, incident (#411)
- #300 hostd lock never reclaimed while its owner lives (#410)
- #301 One atomic write helper (.pids, token, scrollback, crew files) (#413)
- #302 Protocol version actually checked
- #303 Orphan sweep signals exact pids only (#409)
- #304 Bounded queues, hello deadline, "busy" never read as "not running" (#410)
Phase 7: Atlas Crew safe to leave unattended
- #290 P0 pause/cancel miss engine tasks; timeout orphans agents
- #291 P0 corrupt state fails open (un-pauses crew, erases secrets)
- #292 Cancel not authoritative
- #293 JSONL logs not crash-safe
- #294 Automation loops / re-fires
- #295 Unbounded task log, O(file) reads
- #296 Prepare deadline, global agent cap, per-agent memory
- #297 Delete orphans + docs drift
- Real crew server end to end in CI (systemd + ssh, fake engine): PR #424.
- Existing crew work: #168, #200, #210–#216
Phase 8: better than VS Code / Zed on Linux
- #306 P0 autosave never overwrites external edits (#328)
- #305 Links / Open in editor / Reveal on Linux (#417)
- #414 security diff prefixes and external diff drivers no longer defeat the commit-message secret filter (#415)
- #307 git status: filter, debounce, single-flight, 3 spawns instead of 5 (#429)
- #308 Virtualized lists, fast quick-open (.27) Done: #479, ships in alpha.27.
- #309 No full-document copy per keystroke (.27) Done: #477, ships in alpha.27.
- #310 Parallel untracked reads in Changes (.27) Done: #478, ships in alpha.27.
Phase 9: delivery quality
- #312 Execute every shipped artifact before publish: Linux done (#419); Windows/macOS (.27) Done: Linux #419 (alpha.26), Windows/macOS #483 (alpha.27).
- #313 Kill switch / yank honoured by clients (.27) Done: #482, ships in alpha.27.
- #311 Mobile release gate
- #314
release:teston PRs - #315 Flaky/ignored tests: fixed so far #416 (crew sign-in row), #421 (cache-hit timing), #431 (stderr trimmer race), #410 (control busy-queue races); rest .27 Done: #416, #421, #431, #410, #446 (alpha.26); #489, #490, #491 (alpha.27). Issue closed.
- #316 Per-OS contributor setup docs
- #317 release.yml duplication, cfg sprawl (.27) Partly: #488 (one toolchain action, manifest lists only built platforms; alpha.27). Open: platform
cfgbranches outsideatlas_core::sys, the largest test files.
Phase 10: reports that lead to fixes
- #318 Symbols, commit/build id, native crash record (.27) Done: #470, ships in alpha.27.
- #319 Redacted, pruned crash files (#330)
- #320 Fingerprints + search before new issue (.27)
- #322 "Closed unexpectedly" card on next launch (.27) Done: #468, ships in alpha.27.
- #321 Notify reporters when a fix ships (.27)
- #426 Gtk-CRITICAL
gtk_widget_get_scale_factoron every Linux start (found by #419) Done: #461, ships in alpha.27.
Suggested execution order across phases
- Data loss / safety: #306, #290, #291, #319.
- It opens and explains itself: #265, #266, #272, #273, #298, #299.
- Never ship broken: #283, #312, #313, #314, #318.
- Daily-driver parity on Linux: #305, #269, #267, #278, #307.
- Speed with numbers: #284 then #285–#288, #308, #309.
- Agents/contributors on Linux: #280–#282, #316.
- Vorherrschende Sprache
- Rust
- Sterne
- 3
- Forks
- 1
- Ø Merge
- 9 Std. 51 Min.
- Gemergte PRs (30 T.)
- 310
Entwicklungsumgebung
- Kein Dockerfile und keine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus codeatlasdev/atlas
-
type: bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 75/100
codeatlasdev/atlas#597 ·
Maintainer antworten meist innerhalb von 1 Tag
-
area: ci os: linux type: bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
codeatlasdev/atlas#496 ·
Maintainer antworten meist innerhalb von 1 Tag
-
area: ci type: bug
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 68/100
codeatlasdev/atlas#596 ·
Maintainer antworten meist innerhalb von 1 Tag
-
os: linux type: bug
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 68/100
codeatlasdev/atlas#591 ·
Maintainer antworten meist innerhalb von 1 Tag
-
flaky: Windows scripts job hits test timeouts (check-dco, i18n runner/translate, check-changed)Offenarea: ci os: windows type: bug
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 56/100
codeatlasdev/atlas#550 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
Alle Issues in codeatlasdev/atlas
Ähnliche Issues
-
marketing
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 74/100
kinqsradio/orbyn-engineering#729 ·
-
Plans page scenario races Shift+Tab against the plan list being drawn again in Firefox and WebKitOffenbug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 83/100
nledford/Ladderback#1091 ·
Maintainer antworten meist innerhalb von 1 Tag
-
bug fix packaging ui user-sprint
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
Vondor/KassenSturz#1197 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 82/100
Maintainer antworten meist innerhalb von 1 Tag