surface — OKF Bundle for Developer Tooling
OKF ✓ v0.1Portable, always-fresh docs for agents and humans. A Surface hub is a conformant OKF concept; Surface adds the freshness OKF leaves out - it fails the build when the code a doc describes changes. Deterministic, no LLM.
Best for
- Claude Code and AI coding agents
- Knowledge graph and knowledge management systems
- Developer tooling and DevOps workflows
- Command-line workflows
What it does
- Portable, always-fresh docs for agents and humans.
- A Surface hub is a conformant OKF concept; Surface adds the freshness OKF leaves out - it fails the build when the code a doc describes changes.
- Deterministic, no LLM..
How to use with AI agents
Step 1: Clone the repository
git clone https://github.com/Connorrmcd6/surface
cd surfaceStep 2: Point your AI agent at the bundle directory
# Claude Code
claude /path/to/surfaceFrequently Asked Questions
Is surface OKF conformant?
Yes, surface is OKF conformant (version 0.1). This means it follows the Open Knowledge Format specification.
How do I install surface?
Clone the repository and point your AI agent at the bundle directory. The agent will automatically discover and load the OKF knowledge. No additional tools or SDKs are required.
What AI agents can use surface?
surface works with any AI agent that supports OKF bundles, including Claude Code. Just point your agent at the bundle directory.
What are alternatives to surface?
Similar bundles include okf-gem, okq, throughline. Browse these for alternative approaches and feature sets.