Skip to main content

Installation

On GitHub Releases you can download the binary for your machine: there is a single binary per OS and CPU (pick the matching asset, make it executable if needed, and run it).

Quick launch​

The moondust package on npm is a small launcher that downloads the same kind of binary for your platform, caches it under ~/.cache/moondust/, and starts the app. You can run it with either Bun or Node.js (npm); pick one:

bunx moondust
npx moondust

Both commands behave the same. Follow the prompts if you want a specific version instead of the default.

Linux​

Extra dependency on Linux

The desktop build needs WebKit2GTK on the host (not inside the binary). On Debian/Ubuntu: sudo apt install libwebkit2gtk-4.1-0. Package names differ elsewhere; if startup fails with a missing libwebkit2gtk-4.1.so.0, install your distro’s WebKit2GTK 4.1 runtime.

After you install​

  1. Start Moondust (binary or bunx / npx launcher).
  2. Add or open a project: pick a local folder (or follow the flow to create from a remote, if offered).
  3. Create a thread under that project (sidebar: plus under the project).
  4. Configure a chat provider in Settings → Providers:
    • OpenRouter: OAuth or API key (no extra install).
    • Cursor: install Cursor Agent CLI so agent is on PATH.
    • Claude: install Claude Code so claude is on PATH.
  5. Optionally set the utility model (same screen) for commit messages, review drafts, quick questions, and Git wizard conflict help.
  6. Choose provider + model in the thread’s chat bar, then send a message.

The home view stays empty until you select a thread from the sidebar.

Models​

Configure providers and keys in the app when prompted. Provider-specific notes live under Providers.

For a feature tour, see Features overview.