\n\nOKF Studio is a local-first desktop workspace for [Open Knowledge Format](https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/okf) bundles. Open a folder of Markdown as a graph and a reader. Question it with the agent you already use, and review every proposed change before it touches a file.\n\nA bundle stays what it was: plain Markdown with YAML frontmatter, on your disk, readable without this app. Opening a folder is read-only. The app reaches the network only when you act, and no agent can apply its own change. There is no account and no telemetry.\n\nFree and open source under the [MIT license](LICENSE). Built with [Tauri 2](https://tauri.app/): a Rust core plus the system webview.\n\n## Download\n\nCurrent builds are on the [releases page](https://github.com/saschb2b/okf-studio/releases/latest), with install options on the [download page](https://saschb2b.github.io/okf-studio/download/).\n\n| Platform | Formats |\n|----------|---------|\n| Windows | `.msi` or NSIS `.exe` (x64) |\n| Linux | `.deb` or AppImage (x86_64) |\n| macOS | Build from source, see [Develop and run](#develop-and-run) |\n\nThere is no macOS build in the release matrix. Builds are not code-signed, so your OS may show an \"unverified publisher\" prompt on first launch.\n\n## What it does\n\n**Understand.** A force-directed graph of concepts and links, colored by type, sits beside a Markdown reader. The reader shows frontmatter, syntax-highlighted code, and a relationship panel naming what a concept links to and what cites it. Treemap, sunburst, and circle-packing views compare a bundle's composition. Full-text search, type and tag filters, a command palette, and live reload when files change on disk. A pacing mode reads a concept word by word, with rereading and non-prose blocks kept in reach.\n\n**Ask.** Connect a subscription agent, a custom [ACP](https://agentclientprotocol.com/) command, an API-key-backed endpoint, or a fully local model, and run parallel threads beside the bundle. Retrieval routes a question through local evidence and hands back a receipt for every selection. Tools, permissions, and proposed writes stay visible, and credentials live in the operating system's credential store rather than in the app.\n\n**Improve.** Proposed changes land in a staged tree, never on your files. Each diff hunk is reviewable, deterministic validation runs against the OKF spec, and applying is one transaction you can restore. Moves, retirements, and redirects go through the same path.\n\n**Keep.** Review, stage, commit, and inspect history for the bundle's repository from inside the workspace. Fetch, pull, and push happen only when you ask for them.\n\nThe complete, specified feature set lives in [`docs/features/`](docs/features/).\n\n## Built on an open format\n\n[Open Knowledge Format](https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/okf) is Google's open, vendor-neutral spec for packaging knowledge that an agent or a person can read. It is plain Markdown with YAML frontmatter, organized as a portable bundle. No SDK, no database, no lock-in.\n\nStudio reads any conformant bundle from any producer, and never refuses one for soft issues. Problems surface as [validation](docs/features/validation.md) findings instead.\n\n[Open Design System Format](https://saschb2b.github.io/Open-Design-System-Format/) is a profile of OKF for design systems. It adds machine-readable tokens and runnable HTML and CSS examples, so an agent produces UI that matches the system. Open one and Studio renders its tokens and examples inline.\n\nThis project's own site comes from an ODSF bundle, [`design-system/`](design-system/), which Studio can open and preview.\n\n## Develop and run\n\nPrerequisites: rustup, which installs the Rust toolchain pinned in `rust-toolchain.toml`, Node.js 20.19+ or 22.12+ with pnpm, and platform build tools:\n\n- **macOS:** the Xcode Command Line Tools (`xcode-select --install`).\n- **Ubuntu/Linux:** `libwebkit2gtk-4.1-dev`, `build-essential`, `libssl-dev`, `librsvg2-dev`, and the related GTK packages.\n- **Windows:** the WebView2 runtime and MSVC C++ build tools.\n\n```bash\npnpm install\npnpm dev # frontend only, in a browser against a mock bundle\npnpm tauri dev # the full desktop app with hot reload\npnpm storybook # component playground on :6006\npnpm tauri build # installers for host platform (.app/.dmg on macOS, .deb/AppImage on Linux, .msi/.exe on Windows)\n```\n\nBefore finishing a change, run the gate that mirrors CI:\n\n```bash\npnpm lint # eslint, type-aware\npnpm typecheck # tsc --noEmit\npnpm check:theme # tokens, AA contrast, design-system sync\npnpm test # unit and component lanes\npnpm test:integration # full-app and axe journeys\npnpm test:stories # every story headless in Chromium\npnpm build # production frontend build\ncargo clippy -p okf-core --all-targets -- -D warnings\ncargo test -p okf-core # core tests, run against docs/\ncargo clippy -p okf-viewer --all-targets -- -D warnings\ncargo test -p okf-viewer --no-fail-fast # agent, source, and transaction tests\nnode scripts/okf-validate.mjs docs # OKF conformance of the spec bundle\n```\n\nThe site under [`site/`](site/) builds separately with `pnpm --dir site build` and deploys to GitHub Pages.\n\n## Repository layout\n\n| Path | Contents |\n|------|----------|\n| [`src/`](src/) | React 19 and TypeScript frontend, organized by domain: graph, reader, agent panel, Git, shell. |\n| [`src-tauri/`](src-tauri/) | Tauri 2 app shell: commands and events, plugins, capabilities, file watcher, agent host. |\n| [`crates/okf-core/`](crates/okf-core) | Pure-Rust core: detection, parsing, graph, validation. No GUI dependencies. |\n| [`docs/`](docs/) | The OKF product bundle: features, UX, architecture, reference. The source of truth, and the app's built-in sample. |\n| [`design-system/`](design-system/) | The ODSF bundle the site's visual language comes from. |\n| [`site/`](site/) | Astro marketing and download site. |\n| [`scripts/`](scripts/) | Repository tooling, including the zero-dependency OKF conformance checker. |\n| [`AGENTS.md`](AGENTS.md) | Architecture, conventions, and the local check gate, for human and agent contributors alike. |\n\n## The spec lives in `docs/`\n\n[`docs/`](docs/) is a conformant OKF bundle specifying what OKF Studio does and why. The app renders it as its built-in sample, so the product dogfoods the format it reads. It is the source of truth for humans and agents:\n\n- Read the relevant concept before changing behavior. Start at [`docs/index.md`](docs/index.md).\n- Update the spec in the same change, so it never drifts from the code. On a conflict, the bundle wins.\n- Record decisions in the bundle, with a dated entry in [`docs/log.md`](docs/log.md), rather than only in a commit message.\n- Validate before finishing. `node scripts/okf-validate.mjs docs` must report 0 errors.\n\n## Contributing\n\nIssues and pull requests are welcome. See [`CONTRIBUTING.md`](CONTRIBUTING.md) for what a complete change looks like, and [`AGENTS.md`](AGENTS.md) for the full architecture and conventions. The short version:\n\n- A user-facing change lands on three surfaces in one change: code, the `docs/` spec, and the site's copy.\n- Run the local gate under Develop and run before opening a pull request. CI runs the same checks.\n- Commit messages and pull request descriptions follow the house style in `AGENTS.md`: conventional-commit titles, and prose written for a reader outside the repository.\n\n## License\n\n[MIT](LICENSE)\n",
"bytes": 8539,
"sha": "cdd68a320deed0f20711263f3c07b15601e07f12e7766931335a21c826c58d18",
"repo_slug": "saschb2b/okf-studio",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/okf_saschb2b_okf_studio_docs_index_md_efb48380/readme"
}
![\"\"](\"src-tauri/icons/icon.png\"){kind=icon}
\n![\"OKF](\"site/public/screenshot-graph.webp\")
\n \n