Local-first graph engineering workbench for Open Knowledge Format (OKF).
OKFForge is a Motion-inspired Markdown IDE upgraded for dual knowledge + agent graphs: edit concepts, search the graph, run impact analysis, classify documents into searchable OKF repos, and wire skills into LangChain DeepAgents and Claude plugins / MCP.
| Mode | Best for |
|---|---|
| Web | Live preview, Playwright, Vercel deploy, browser-agent testing |
| Desktop (Tauri) | Native folder picker, jailed filesystem, standalone installers |
Edit OKF concepts with YAML frontmatter, typed links, and live preview — Impact and Pack shortcuts on the toolbar.
Search the graph, compute blast radius for a concept, and build N-hop context packs for agent runs.
Cycle light / dark / system from the header. The palette is two layers of CSS
variables behind @theme inline, so flipping the theme repaints every existing
utility class without touching a component.
Map okf-graph-eng skills to DeepAgent skills / subagents and export JSON or Python scaffolding.
Same workbench scales to a narrow viewport for on-the-go browsing of catalogs and the learning path.
| Doc | Description |
|---|---|
| FEATURES.md | Complete feature list — editor, graph ops, classify, DeepAgents, plugins, desktop |
| USER_GUIDE.md | How to use and configure (includes running as a Tauri app) |
| DEVELOPERS.md | Setup, test, architecture — build & deploy Tauri locally |
| DESKTOP.md | Short Tauri dual-mode reference (web FS API + standalone binaries) |
npm install
npm run dev # http://0.0.0.0:8080Open the app, walk Learn OKF, or Open → sample / GitHub / folder / scaffold.
npm run verify # typecheck + unit + Playwright e2e
npm run build # production (Vercel / Nitro)# Requires Rust + Tauri OS deps — see DEVELOPERS.md §2 and §7
npm install
npm run tauri:dev # native window + Vite HMR on :8080
# Release binary + installers on this machine
npm run tauri:build
# → src-tauri/target/release/okfforge[.exe]
# → src-tauri/target/release/bundle/ (dmg, msi, AppImage, deb, …)Once the desktop app is installed, open Settings and click Install okff to
put a launcher on your PATH:
okff . # open the current directory in OKF Forge
okff ~/my-okf # open a specific oneLocal install and verification steps: DEVELOPERS.md §7.
End-user desktop walkthrough: USER_GUIDE.md §2.
- Edit OKF Markdown with Preview / Markdown / Split modes and ⌘S save
- Explore catalogs with type badges and validation status
- Search concepts; run impact, context packs, and neighborhood graphs
- Classify raw docs into typed OKF paths and build a new repo
- DeepAgents — map okf-graph-eng skills → JSON / Python export
- Plugins & MCP — configure Claude plugins and MCP servers (browser-persisted)
- Desktop or web — same UI; native FS jail on Tauri,
/api/fsfor Playwright - Light, dark, or system theme — follows your OS by default, remembered after that
- Zoom the type on desktop with ⌘+ / ⌘− / ⌘0, also remembered
- Open from the shell with
okff <dir>— installed from Settings, macOS for now - Navigate the file tree by keyboard — arrows, Home/End, and type-to-find
Details: FEATURES.md · Walkthrough: USER_GUIDE.md
- SpillwaveSolutions/okf-plugin —
okf-graph-engskills & sample-okf - SpillwaveSolutions/motion — UI inspiration (local-first technical writing IDE)
Private / project workspace unless otherwise stated by the publisher.