Home - ferrule-io/ok-fine GitHub Wiki

ok-fine is a knowledge repository for AI agents. It stores project knowledge as Open Knowledge Format (OKF) v0.2 bundles and serves it over MCP (stdio or Streamable HTTP) and a REST JSON API, protected by OAuth 2.1 bearer tokens from your own identity provider.

New here? Run the Quick start from the README, then read:

• Running locally: npm CLI, stdio, flags, git credentials
• How it works: data layout, concepts, actors, trust tiers
• Connecting an MCP client
• Using ok-fine from coding agents: agent package, lifecycle, per-harness setup
• Organization rollout: remote MCP connectors for non-coding chat users, desktop harnesses, and workspace setup
• MCP tools
• REST API
• Authentication and authorization
• Git storage and remote sync
• Configuration: environment variables
• Deploying with Helm
• Development: build, test, layout, CI and releases