Installation

Runne Engine is part of the Runne monorepo and requires pnpm.

Dependencies

pnpm install --frozen-lockfile

Default — bundled desktop runtime

The desktop app starts a bundled protected supervisor by default; you do not pre-start a separate runned:

pnpm --filter @runne/desktop stage:bundled-daemon
pnpm --filter @runne/desktop tauri dev

External runtime + CLI

To use the CLI or the explicit external desktop mode, install the runtime and the CLI into a local bin directory:

pnpm install:local

By default this installs two commands side by side in ~/.local/bin:

runne --version
runned

If ~/.local/bin is not on your PATH, add it:

export PATH="$HOME/.local/bin:$PATH"

To install into a different directory:

scripts/install-local.sh --bin-dir "$HOME/bin"

Run the external runtime

Start the runtime daemon in one terminal:

runned

Point the desktop app at it with the explicit native flag:

pnpm --filter @runne/desktop tauri dev -- -- --external-runtime

Verify

Run the full local gate without spending GitHub Actions minutes:

pnpm ci:local

The Local Engine contract tests run separately on Linux/macOS:

bash scripts/local-engine/ci.sh

CI

Automatic cross-platform CI runs on SourceCraft (.sourcecraft/ci.yaml) — Ubuntu, macOS ARM, and Windows, across pinned and MSRV toolchains. macOS Intel is removed from the automatic matrix. GitHub Actions workflows are archived in .github/workflows.disabled/.

Related

• CLI — the runne commands.
• Overview — what the engine is.