Stop re-explaining your project to every agent. okf-gem turns your knowledge into a markdown knowledge graph: one durable home your team and your agents create, keep fresh, and read from. Open source, 100% local.
Pare de reexplicar o seu projeto a cada agente. okf-gem transforma o seu conhecimento em um grafo de conhecimento em markdown: um lar durável que o seu time e os seus agentes criam, mantêm em dia e leem. Open source, 100% local.
OKF: an open, vendor-neutral format for project knowledge, from Google Cloud (2026). A bundle is a directory of Markdown + YAML that people and agents read from one source. One file, one concept. The links are the graph. Just .md in your repo, versioned with the code.
OKF: um formato aberto e neutro para o conhecimento do projeto, do Google Cloud (2026). Um bundle é um diretório de Markdown + YAML que pessoas e agentes leem da mesma fonte. Um arquivo, um conceito. Os links são o grafo. É só .md no seu repositório, versionado junto com o código.
okf-gem is not a system with a database or access controls. It is a local, standardized way to create, maintain, and consume your project's knowledge, with your agent, inside Claude Code, Codex, or any agent. What it takes off your plate:
okf-gem não é um sistema com banco de dados ou controle de acesso. É uma forma local e padronizada de criar, manter e consumir o conhecimento do seu projeto, com o seu agente, dentro do Claude Code, Codex ou qualquer agente. O que ele tira das suas costas:
OKF already decides how knowledge is structured, so you write what matters instead of designing a doc system or arguing about folders.
O OKF já decide como o conhecimento é estruturado, então você escreve o que importa em vez de projetar um sistema de docs ou discutir sobre pastas.
Connections form from the links you already write. You never build or maintain an index, and nothing rots because it fell off a table of contents.
As conexões surgem dos links que você já escreve. Você nunca monta nem mantém um índice, e nada apodrece por ter caído de um sumário.
The bundle is checked as you work, and with the Claude plugin it is kept in sync as the code changes. Curation stops being a chore you forget.
O bundle é checado enquanto você trabalha, e com o plugin do Claude ele fica em dia conforme o código muda. Curadoria deixa de ser uma tarefa que você esquece.
The return is simple: less rework, and knowledge that compounds instead of evaporating between sessions and people.
O retorno é simples: menos retrabalho, e conhecimento que se acumula em vez de evaporar entre sessões e pessoas.
You have read what it does. Now open it and search real knowledge yourself: ask a question, watch the answer surface from across four live bundles at once, and click any concept to read the reasoning behind it, diagrams and all. Then imagine it on your own project.
Você já leu o que ela faz. Agora abra e busque em conhecimento real: faça uma pergunta, veja a resposta surgir de quatro bundles ao vivo de uma vez, e clique em qualquer conceito para ler o raciocínio por trás dele, com diagramas e tudo. Depois, imagine isso no seu próprio projeto.
The knowledge lives as plain Markdown in your repo, in the open OKF format (Google Cloud, 2026). Three cores turn it into something your agents and your team actually use:
O conhecimento vive como Markdown no seu repositório, no formato aberto OKF (Google Cloud, 2026). Três núcleos o transformam em algo que os seus agentes e o seu time realmente usam:
Stop re-explaining the same decisions every session. Your agent writes down the why behind a choice, the part it can never recover from the code, and reads back only what a question needs instead of re-scanning the whole project. You stay the editor, and the reasoning outlives whoever wrote it.
Pare de reexplicar as mesmas decisões a cada sessão. Seu agente registra o porquê de uma escolha, a parte que ele nunca recupera do código, e lê de volta só o que a pergunta precisa, em vez de varrer o projeto inteiro. Você continua o editor, e o raciocínio sobrevive a quem o escreveu.
okf skill .claudeDeterministic checks the agent and your CI can trust: is the bundle valid, is it well curated, what does it actually say. Gate a merge on them, or call them as Ruby objects in your own code. And search answers a question from a fraction of the bundle, so context stays lean.
Checagens determinísticas em que o agente e a sua CI confiam: o bundle está válido, está bem curado, o que ele realmente diz. Bloqueie um merge com elas, ou use como objetos Ruby no seu código. E a busca responde uma pergunta a partir de uma fração do bundle, então o contexto fica enxuto.
okf validate · lint · searchThe same files your agents read become a page your whole team can browse and search. One search reaches across every bundle you own, from a phone or a desktop. Serve it live, or export one static file that hosts anywhere.
Os mesmos arquivos que os seus agentes leem viram uma página que todo o time navega e busca. Uma busca alcança todos os bundles que você tem, do celular ao desktop. Sirva ao vivo, ou exporte um arquivo estático que hospeda em qualquer lugar.
okf server · render · registryTwo ways in; either one puts okf on your PATH.
Dois caminhos; qualquer um coloca o okf no seu PATH.
Teach your agent the format. Claude Code, or any other agent.
Ensine o formato ao seu agente. Claude Code, ou qualquer outro.
okf skill .claude # or: okf skill .agentsOpen your agent where your project lives.
Abra o agente onde o seu projeto está.
claudeTwo ways in, by what you already have. Docs keep every word; code gets written up for you.
Dois caminhos, conforme o que você já tem. Os docs mantêm cada palavra; o código é escrito para você.
/okf maintain in your agent session to keep it in sync as the code changes, or install the Claude plugin so a Stop hook does it for you. Register it once (okf registry set <folder>) and every verb reaches it as @slug from anywhere, with a bare okf server opening everything you keep. To share it, okf render <folder> writes the same page as one static file you can host.
Quando tiver um bundle, rode /okf maintain na sessão do agente para mantê-lo em dia conforme o código muda, ou instale o plugin do Claude para um Stop hook fazer isso por você. Registre-o uma vez (okf registry set <pasta>) e todo verbo o alcança como @slug de qualquer lugar, com um okf server sem argumentos abrindo tudo o que você mantém. Para compartilhar, o okf render <pasta> escreve a mesma página como um arquivo estático que você hospeda.
Curation on autopilot: validate and lint after every edit.
Curadoria no automático: validate e lint após cada edição.
Meet the plugin →Conheça o plugin → 🐳Run the whole CLI with no Ruby, straight from the image.
Rode a CLI inteira sem Ruby, direto da imagem.
Run in Docker →Rodar no Docker → 📚Guides, the CLI reference, and the full OKF spec.
Guias, a referência da CLI e a spec OKF completa.
Read the docs →Ler a documentação → 📝Why OKF, and the thinking behind the gem.
Por que OKF, e o raciocínio por trás da gem.
Read the blog →Ler o blog →