Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/release-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

- **macOS** (Apple Silicon, macOS 13 or newer): `Lucid-…-mac-arm64.dmg`. Open it, drag Lucid to Applications. Lucid is not notarized by Apple, so macOS asks once: on macOS 15 open **System Settings → Privacy & Security** and click **Open Anyway**; on macOS 13 and 14 right-click the app and choose **Open**.
- **Windows** (Windows 10 or newer, 64-bit): `Lucid-…-win-x64.exe`. Run it; it installs for you and starts Lucid. Lucid is not signed, so Windows SmartScreen may say "Windows protected your PC": click **More info**, then **Run anyway**. A portable `.zip` is also there.
- **Linux** (64-bit): `Lucid-…-linux-amd64.deb` for Debian and Ubuntu (`sudo apt install ./Lucid-…-linux-amd64.deb`), or `Lucid-…-linux-x64.AppImage` for other distributions (make it executable, then run it).
- **Linux** (64-bit): `Lucid-…-linux-amd64.deb` for Debian and Ubuntu (`sudo apt install ./Lucid-…-linux-amd64.deb`), or `Lucid-…-linux-x86_64.AppImage` for other distributions (make it executable, then run it).

Then start [LM Studio](https://lmstudio.ai) with the model `qwen/qwen3.8-27b`. Details are in the [README](https://github.com/triggeredcode/lucid#install).

Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ The [website](https://triggeredcode.github.io/lucid/#download) offers the right
|---|---|---|
| **macOS** | `Lucid-<version>-mac-arm64.dmg` (or `.zip`) | Apple Silicon, macOS 13 or newer |
| **Windows** | `Lucid-<version>-win-x64.exe` installer (or the portable `.zip`) | Windows 10 or newer, 64-bit |
| **Linux** | `Lucid-<version>-linux-amd64.deb`, or `Lucid-<version>-linux-x64.AppImage` | 64-bit; the `.deb` is for Debian and Ubuntu |
| **Linux** | `Lucid-<version>-linux-amd64.deb`, or `Lucid-<version>-linux-x86_64.AppImage` | 64-bit; the `.deb` is for Debian and Ubuntu |

1. **Install it.**
- **macOS:** open the `.dmg` and drag **Lucid** to **Applications**. macOS will say it cannot check the app for malicious
Expand All @@ -98,7 +98,7 @@ The [website](https://triggeredcode.github.io/lucid/#download) offers the right
so Windows SmartScreen may say "Windows protected your PC": click **More info**, then **Run anyway**. To remove it:
Settings → Apps → Lucid.
- **Linux:** `sudo apt install ./Lucid-<version>-linux-amd64.deb` (then start **Lucid** from the menu, or `lucid`), or with the
AppImage: `chmod +x Lucid-<version>-linux-x64.AppImage && ./Lucid-<version>-linux-x64.AppImage`. On Ubuntu 24.04 and newer an
AppImage: `chmod +x Lucid-<version>-linux-x86_64.AppImage && ./Lucid-<version>-linux-x86_64.AppImage`. On Ubuntu 24.04 and newer an
AppImage can stop with a sandbox message: use the `.deb`, or start the AppImage with `--no-sandbox`.
2. Install [LM Studio](https://lmstudio.ai) (it runs on all three systems), download the model **`qwen/qwen3.8-27b`**, and
start its local server (Developer tab). Lucid's pill at the top says what is missing and can load the model for you.
Expand Down
2 changes: 1 addition & 1 deletion apps/desktop/electron-builder.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Packaging: `pnpm dist` builds the installers for the system it runs on, into release/:
# macOS (Apple Silicon) Lucid-<version>-mac-arm64.dmg and .zip
# Windows (x64) Lucid-<version>-win-x64.exe (installer) and .zip
# Linux (x64) Lucid-<version>-linux-x64.AppImage and Lucid-<version>-linux-amd64.deb
# Linux (x64) Lucid-<version>-linux-x86_64.AppImage and Lucid-<version>-linux-amd64.deb
appId: io.github.triggeredcode.lucid
productName: Lucid
copyright: Copyright © 2026 Omkar Tripathi
Expand Down
4 changes: 2 additions & 2 deletions apps/desktop/electron/site.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -250,7 +250,7 @@ describe("pickAssets", () => {
asset("Lucid-0.2.0-win-x64.exe", 90_000_000),
asset("Lucid-0.2.0-win-x64.zip"),
asset("Lucid-0.2.0-linux-amd64.deb"),
asset("Lucid-0.2.0-linux-x64.AppImage"),
asset("Lucid-0.2.0-linux-x86_64.AppImage"),
asset("SHA256SUMS", 600),
],
});
Expand All @@ -259,7 +259,7 @@ describe("pickAssets", () => {
expect(picked.windows.primary?.name).toBe("Lucid-0.2.0-win-x64.exe");
expect(picked.windows.secondary?.name).toBe("Lucid-0.2.0-win-x64.zip");
expect(picked.linux.primary?.name).toBe("Lucid-0.2.0-linux-amd64.deb");
expect(picked.linux.secondary?.name).toBe("Lucid-0.2.0-linux-x64.AppImage");
expect(picked.linux.secondary?.name).toBe("Lucid-0.2.0-linux-x86_64.AppImage");
expect(picked.sums?.name).toBe("SHA256SUMS");
expect(picked.mac.primary?.url).toContain("/releases/download/v0.2.0/");
});
Expand Down
2 changes: 1 addition & 1 deletion docs/mcp.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ claude mcp add lucid -e ELECTRON_RUN_AS_NODE=1 -- /opt/Lucid/lucid /opt/Lucid/re
```

An AppImage mounts itself at a different place each time it runs, so it has no fixed path for this: use the `.deb`, or unpack
the AppImage once (`./Lucid-<version>-linux-x64.AppImage --appimage-extract`) and use the `lucid` and `resources/lucid-mcp.mjs`
the AppImage once (`./Lucid-<version>-linux-x86_64.AppImage --appimage-extract`) and use the `lucid` and `resources/lucid-mcp.mjs`
inside the `squashfs-root` folder.

Then ask Claude Code, for example: *"Read my open Lucid page and add a Pitfalls section."*
Expand Down
6 changes: 3 additions & 3 deletions site/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -768,11 +768,11 @@ <h3>Lucid for Linux</h3>
</div>
<p><b>Any distribution</b>, from the .AppImage:</p>
<div class="code">
<pre><code>chmod +x Lucid-*-linux-x64.AppImage
./Lucid-*-linux-x64.AppImage</code></pre>
<pre><code>chmod +x Lucid-*-linux-x86_64.AppImage
./Lucid-*-linux-x86_64.AppImage</code></pre>
<button
type="button"
data-copy="chmod +x Lucid-*-linux-x64.AppImage &amp;&amp; ./Lucid-*-linux-x64.AppImage"
data-copy="chmod +x Lucid-*-linux-x86_64.AppImage &amp;&amp; ./Lucid-*-linux-x86_64.AppImage"
data-copy-appimage
>
Copy
Expand Down
Loading