Desktop alpha

Run SkillRun Desktop as a local control console.

Desktop is the tray-first consumer console for SkillRun Core. Use it to inspect local capsules, review Team Library catalog status and install plans, preview Router exposure, mount MCP clients, and read run evidence without bypassing Core.

Download alpha prerelease Install Core first Open Desktop repo

Install the Core CLI

Desktop is useful only after the Core CLI is available on the machine. Start here, then verify the binary before launching the app.

macOS / Linux

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/iiwish/skillrun/releases/latest/download/skillrun-installer.sh | sh
skillrun --version

Windows PowerShell

powershell -ExecutionPolicy Bypass -c "irm https://github.com/iiwish/skillrun/releases/latest/download/skillrun-installer.ps1 | iex"
skillrun --version

Try the alpha binary

desktop-v0.1.0-alpha.6 is a public prerelease for validating Desktop packaging, the first-run demo path, and remote catalog URL read-only checks. It is not a stable Desktop release.

Download alpha prerelease

Release

desktop-v0.1.0-alpha.6

Core gate

SkillRun Core v0.6.8 real smoke

Status

Prerelease, not latest

Alpha.6 focus

First-run demo guidance from the main workspace into the local hero catalog.
Remote Team Library catalog URLs for read-only inspect, status, and install plan.
Low-friction Team Library hero catalog smoke with `command_hello` as the default sample.
Hero flow coverage: inspect -> install plan -> install apply -> enable -> exposure -> router dry-run.

Alpha installation notes

macOS packages are currently unsigned and not notarized, so macOS may show a security prompt on first launch.
Desktop does not bundle or install the Core CLI, Python, Node, npm, pip packages, or action dependencies.
Older Core versions may lack remote catalog URLs, Team Catalog status, or Router routes JSON surfaces. Upgrade Core or configure a Runtime bin that points at a compatible `skillrun`.
Use this build for local validation before relying on it as a daily control plane.

artifacts

macOS arm64 / x64 DMG and app tar
Windows x64 NSIS installer
Linux AppImage, deb, and rpm

Run Desktop from source

The source path remains the clearest option for development and local debugging. It starts a local Tauri development build; it is not a background Router daemon.

alpha source path

git clone https://github.com/iiwish/skillrun-desktop.git
cd skillrun-desktop
npm install
npm run skillrun:verify-local
npm run tauri -- dev

Verify what Desktop will see

which skillrun
skillrun --version
npm test -- --run
npm run smoke:real-core

What the app controls

Core JSON surfaces only

Capsules

Import `.skr`, inspect inventory, and enable or disable local exposure intent through Core commands.

Team Library

Paste a shared catalog URL for read-only inspect/status/plan, or use a local catalog path for guarded `.skr` install apply after checksum verification.

Router and clients

Preview Router exposure, run mount plan/apply, and keep MCP clients pointed at `skillrun router serve --mcp`.

Run evidence

Browse summary-only run records and inspect structured outcomes through Core JSON surfaces.

Boundaries

Desktop does not replace SkillRun Core and does not define its own install, import, mount, or rollback semantics.
Desktop does not start a hidden Router daemon. MCP clients launch `skillrun router serve --mcp` from their own config.
Desktop does not install Python, Node, npm, pip packages, or other action dependencies.
Desktop does not make marketplace, publisher identity, signed trust, or OS sandbox claims.

Recommended first run

01

Install Core and run the 5-minute path.
02

Launch Desktop and try the local hero catalog, or paste a shared team catalog URL for read-only review.
03

Use a local catalog/package path when you are ready to apply a guarded `.skr` import.
04

Enable exposure only after review, then mount the Router into your MCP client.