From cce680d2920a01fc569c6f0c19da5f193f1dfdd3 Mon Sep 17 00:00:00 2001 From: lorenzozane Date: Tue, 8 Sep 2026 06:13:03 +0000 Subject: [PATCH] docs: clarify Linux desktop availability in README (#7698) README advertised a Linux AppImage on GitHub Releases while v0.16.1 and later stable releases only publish macOS/Windows artifacts. Clarify that Linux users can run from source today and that a prebuilt Linux release is pending, with links to the source-run instructions and tracker #4368. Fixes #6190 --- README.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index d9b11d89e2..9dabc68782 100644 --- a/README.md +++ b/README.md @@ -259,7 +259,7 @@ OpenDesign (OD) is the open-source alternative. Same loop, same artifact-first m - ๐Ÿค– **Agent-native, model-agnostic.** We don't ship an agent. The `claude` / `codex` / `cursor-agent` / `copilot` / `hermes` / `kimi` already on your `PATH` are the design engine. Swap with one click. - ๐Ÿง  **Brand-grade by default.** Every render reads the active package's `DESIGN.md` as the core brand contract. 151 design-system packages ship with the repo; legacy packages may be `DESIGN.md`-only, while newer packages can add `manifest.json`, `tokens.css`, components, assets, and provenance. Drop a folder in, the picker finds it. -- ๐Ÿ–ฅ๏ธ **Local-first, BYOK at every layer.** Native desktop apps for macOS (Apple Silicon + Intel) and Windows (x64). Linux AppImage on the optional release lane. Product analytics and session replay are consent-gated; scrubbed safety and reliability telemetry is always on. Before describing daemon data paths, contributors and operators MUST read `AGENTS.md` โ†’ **Daemon data directory contract**. This README MUST NOT restate it. +- ๐Ÿ–ฅ๏ธ **Local-first, BYOK at every layer.** Native desktop apps for macOS (Apple Silicon + Intel) and Windows (x64). Linux desktop users can currently run OpenDesign [from source](#-run-from-source); the latest official release does not include a prebuilt Linux artifact. Product analytics and session replay are consent-gated; scrubbed safety and reliability telemetry is always on. Before describing daemon data paths, contributors and operators MUST read `AGENTS.md` โ†’ **Daemon data directory contract**. This README MUST NOT restate it. - ๐ŸŒ **Composable on four planes.** **Plugins** carry runnable workflows ยท functional **skills** carry agent behavior ยท **design templates** carry rendering blueprints ยท **design systems** carry the brand. All four use portable, versionable directories that anyone can author and publish. - ๐Ÿ” **Refresh an existing codebase.** Hand a `git` repo + `DESIGN.md` to the agent and it refactors your real components to the brand spec. Dedicated plugins migrate Figma / Pencil workflows into React / Next.js / Vue code. - ๐Ÿ”’ **Privacy by conviction.** Everything runs where your data lives โ€” your laptop, your team's server, your Vercel project. When the network is needed, the BYOK proxy is SSRF-guarded. @@ -287,7 +287,7 @@ The fastest way to use OpenDesign. No Node, no pnpm, no clone. - **macOS** (Apple Silicon ยท Intel x64) โ†’ [**open-design.ai**](https://open-design.ai/?utm_source=github&utm_medium=referral&utm_content=readme_download_macos) or [GitHub Releases](https://github.com/nexu-io/open-design/releases) - **Windows** (x64) โ†’ [**open-design.ai**](https://open-design.ai/?utm_source=github&utm_medium=referral&utm_content=readme_download_windows) or [GitHub Releases](https://github.com/nexu-io/open-design/releases) -- **Linux** (AppImage, optional lane) โ†’ [GitHub Releases](https://github.com/nexu-io/open-design/releases) +- **Linux** โ†’ No prebuilt Linux artifact is currently published in the official releases. For now, [run OpenDesign from source](#-run-from-source); Linux release work is tracked in [#4368](https://github.com/nexu-io/open-design/issues/4368). After install: the app auto-detects every coding-agent CLI on your `PATH`, loads 100+ functional skills, the separate rendering-template catalog, and 151 design systems, and lets you type a brief in the entry view. @@ -606,7 +606,8 @@ Full architecture โ†’ [`docs/architecture.md`](docs/architecture.md). Skill prot - [x] **0.11.0** โ€” _The Bazaar_: built in the open โ€” a community marketplace of plugins and design systems anyone can pick from and contribute to - [x] **0.12.0** โ€” _Brand-backed Design System_: turn the brand you already own into a reusable, portable `DESIGN.md` system - [x] **0.13.0** โ€” _Stay in Flow_: native session resume, faster model picking, and export straight to screenshot-backed PPTX / PDF -- [x] Packaged Electron builds โ€” macOS (Apple Silicon + Intel) + Windows (x64) + Linux AppImage (optional lane) +- [x] Published desktop releases โ€” macOS (Apple Silicon + Intel) + Windows (x64) +- [ ] Published Linux desktop release (optional lane) โ€” tracked in [#4368](https://github.com/nexu-io/open-design/issues/4368) - [ ] Comment-mode surgical edits โ€” partially shipped; reliable targeted patching in progress - [ ] AI-emitted tweaks panel UX โ€” not yet implemented - [ ] `npx od init` to scaffold a project with `DESIGN.md`