Skip to content

Quickstart

KL4A is a native desktop app. Install it, open it, and everything else — creating a bundle, ingesting sources, reviewing mined knowledge, exporting, talking to the agent — happens inside the app itself. There's no CLI you need to touch to get started.

Get the app

Platform Download
Windows ⬇ Installer (.exe)
macOS ⬇ Disk image (.dmg) — universal, runs on Apple Silicon and Intel
Linux ⬇ AppImage

The builds aren't code-signed yet

No Apple Developer ID or Windows signing certificate is set up for this project yet, so your OS will warn you on first launch:

  • macOS — Gatekeeper blocks it as "from an unidentified developer". Right-click the app in Finder and choose Open (once), or run xattr -cr on it.
  • Windows — SmartScreen shows "Windows protected your PC". Click More info → Run anyway.
  • Linux — mark the AppImage executable first: chmod +x KL4A*.AppImage.

Running it from this repository instead

Specific to this repository's source checkout

The rest of this page describes the standalone desktop app releases. If you're working from this repository's v2/kl4a-rs/ source tree instead of a downloaded installer, the same sopkb functionality is reachable through the CLI — either the sopkb-cli/sopkb-mcp/sopkb-server binaries directly, or through the unified kl4a --use sopkb <command> dispatcher built here, which reaches the exact same code:

kl4a --use sopkb init demo-bundle
kl4a --use sopkb scan sources --bundle demo-bundle
kl4a --use sopkb mine demo-bundle --provider fixture
kl4a --use sopkb serve --bundle-dir demo-bundle   # spawns sopkb-server

See kl4a — Unified CLI and Library for how the dispatcher works, and MCP Server for kl4a --use sopkb mcp serve.

First launch

On first launch you land on the bundle picker. Create a new bundle, point it at a folder of SOPs/policies/procedures (Markdown, DOCX, or PDF), and the app walks you through the rest: ingest → inspect what got mined and why → review (approve, reject, defer, edit, comment) → export.

See the Desktop UI Guide for a full screen-by-screen tour.

A richer example

Once you're comfortable with the app, open the included GLP-1 Healthcare SOP reference bundle — a finished, evidence-linked bundle with persisted review states, conflict/freshness reporting, and full OKF/graph/RDF export:

→ examples/glp1-healthcare

Next steps