{
  "markdown": "# OKFForge\n\n**Local-first graph engineering workbench for [Open Knowledge Format (OKF)](https://github.com/SpillwaveSolutions/okf-plugin).**\n\nOKFForge 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.\n\n<p align=\"center\">\n  <img src=\"./screenshots/okf-prod.png\" alt=\"OKFForge — Learn OKF guided tour with sample dual graph loaded\" width=\"100%\" />\n</p>\n\n| Mode | Best for |\n|------|----------|\n| **Web** | Live preview, Playwright, Vercel deploy, browser-agent testing |\n| **Desktop (Tauri)** | Native folder picker, jailed filesystem, standalone installers |\n\n---\n\n## Screenshots\n\n### Markdown editor (split source + preview)\n\nEdit OKF concepts with YAML frontmatter, typed links, and live preview — Impact and Pack shortcuts on the toolbar.\n\n<p align=\"center\">\n  <img src=\"./screenshots/okf-editor.png\" alt=\"OKFForge editor — split Markdown source and rendered preview for Graph Engineer AgentNode\" width=\"100%\" />\n</p>\n\n### Impact analysis & progressive disclosure\n\nSearch the graph, compute blast radius for a concept, and build N-hop context packs for agent runs.\n\n<p align=\"center\">\n  <img src=\"./screenshots/okf-impact.png\" alt=\"OKFForge Graph & Search — impact analysis update order and progressive disclosure pack\" width=\"100%\" />\n</p>\n\n### Light and dark themes\n\nCycle light / dark / system from the header. The palette is two layers of CSS\nvariables behind `@theme inline`, so flipping the theme repaints every existing\nutility class without touching a component.\n\n<p align=\"center\">\n  <img src=\"./screenshots/okf-light.png\" alt=\"OKFForge editor in the light theme — split source and preview with the same typed links and toolbar\" width=\"100%\" />\n</p>\n\n### LangChain DeepAgents export\n\nMap okf-graph-eng skills to DeepAgent skills / subagents and export JSON or Python scaffolding.\n\n<p align=\"center\">\n  <img src=\"./screenshots/okf-deepagent.png\" alt=\"OKFForge DeepAgents view — skill map with okf-init-graph, okf-author, okf-impact\" width=\"100%\" />\n</p>\n\n### Mobile-friendly shell\n\nSame workbench scales to a narrow viewport for on-the-go browsing of catalogs and the learning path.\n\n<p align=\"center\">\n  <img src=\"./screenshots/okf-mobile.png\" alt=\"OKFForge on a 390px mobile viewport — Learn OKF and navigation\" width=\"320\" />\n</p>\n\n---\n\n## Documentation\n\n| Doc | Description |\n|-----|-------------|\n| **[FEATURES.md](./FEATURES.md)** | Complete feature list — editor, graph ops, classify, DeepAgents, plugins, desktop |\n| **[USER_GUIDE.md](./USER_GUIDE.md)** | How to use and configure (includes running as a Tauri app) |\n| **[DEVELOPERS.md](./DEVELOPERS.md)** | Setup, test, architecture — **[build & deploy Tauri locally](./DEVELOPERS.md#7-build--deploy-the-tauri-app-locally)** |\n| [DESKTOP.md](./DESKTOP.md) | Short Tauri dual-mode reference (web FS API + standalone binaries) |\n\n---\n\n## Quick start (web)\n\n```bash\nnpm install\nnpm run dev          # http://0.0.0.0:8080\n```\n\nOpen the app, walk **Learn OKF**, or **Open** → sample / GitHub / folder / scaffold.\n\n```bash\nnpm run verify       # typecheck + unit + Playwright e2e\nnpm run build        # production (Vercel / Nitro)\n```\n\n## Quick start (desktop / Tauri)\n\n```bash\n# Requires Rust + Tauri OS deps — see DEVELOPERS.md §2 and §7\nnpm install\nnpm run tauri:dev      # native window + Vite HMR on :8080\n\n# Release binary + installers on this machine\nnpm run tauri:build\n# → src-tauri/target/release/okfforge[.exe]\n# → src-tauri/target/release/bundle/  (dmg, msi, AppImage, deb, …)\n```\n\nOnce the desktop app is installed, open **Settings** and click **Install okff** to\nput a launcher on your `PATH`:\n\n```bash\nokff .            # open the current directory in OKF Forge\nokff ~/my-okf     # open a specific one\n```\n\nLocal install and verification steps: **[DEVELOPERS.md §7](./DEVELOPERS.md#7-build--deploy-the-tauri-app-locally)**.  \nEnd-user desktop walkthrough: **[USER_GUIDE.md §2](./USER_GUIDE.md#2-running-as-a-tauri-app)**.\n\n## What you can do\n\n- **Edit** OKF Markdown with Preview / Markdown / Split modes and ⌘S save  \n- **Explore** catalogs with type badges and validation status  \n- **Search** concepts; run **impact**, **context packs**, and neighborhood graphs  \n- **Classify** raw docs into typed OKF paths and build a new repo  \n- **DeepAgents** — map okf-graph-eng skills → JSON / Python export  \n- **Plugins & MCP** — configure Claude plugins and MCP servers (browser-persisted)  \n- **Desktop or web** — same UI; native FS jail on Tauri, `/api/fs` for Playwright  \n- **Light, dark, or system** theme — follows your OS by default, remembered after that  \n- **Zoom the type** on desktop with ⌘+ / ⌘− / ⌘0, also remembered  \n- **Open from the shell** with `okff <dir>` — installed from Settings, macOS for now  \n- **Navigate the file tree by keyboard** — arrows, Home/End, and type-to-find  \n\nDetails: **[FEATURES.md](./FEATURES.md)** · Walkthrough: **[USER_GUIDE.md](./USER_GUIDE.md)**\n\n## Related projects\n\n- [SpillwaveSolutions/okf-plugin](https://github.com/SpillwaveSolutions/okf-plugin) — `okf-graph-eng` skills & sample-okf  \n- [SpillwaveSolutions/motion](https://github.com/SpillwaveSolutions/motion) — UI inspiration (local-first technical writing IDE)\n\n## License\n\nPrivate / project workspace unless otherwise stated by the publisher.\n",
  "bytes": 5424,
  "sha": "4734f23e6e49b8565a69b810e69301b6db84ddd388bc2085a3d0450bf4b909e9",
  "repo_slug": "spillwavesolutions/okf-forge",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_spillwavesolutions_okf_forge_public_samp_c23489ae/readme"
}