All videos
0:00 / 0:00
research

Building Docs for Agents, Not Humans: Inside OpenWiki

LangChain14 August 2026Watch on YouTube

Part of series

Ep. 10 · Langchain Llm Prompt

View the series

Description

Brace Sproul, Head of Applied AI at LangChain, breaks down OpenWiki, an open source CLI that generates and maintains documentation built specifically for coding agents to consume, at a LangChain SF meetup. He walks through the three ideas behind it, how the CLI actually works under the hood, early results from DeepSWE benchmark evals, and what the team got wrong along the way. Chapters: 0:00 What OpenWiki is and why Brace built it 0:41 Harrison's question: what comes after OpenClaw? 1:22 Starting with code docs before expanding into general memory 1:43 The three ideas behind OpenWiki 3:04 Why docs built for agents look nothing like docs for humans 4:20 Making it trivial to set up with a CLI 5:14 What OpenWiki actually writes to your repo 7:08 OKF: Google's Open Knowledge Format and why it matters for retrieval 9:00 Does it actually work? Early DeepSWE results 10:11 What we got wrong: humans want to read these docs too 11:35 How the OpenWiki CLI works under the hood 14:59 Open source, MIT licensed, and where to find it 15:48 What's next: better prompting and dedicated retrieval tools Resources: → OpenWiki on GitHub: https://github.com/langchain-ai/openwiki → LangGraph: https://www.langchain.com/langgraph → LangSmith: https://www.langchain.com/langsmith → LangChain Academy: https://academy.langchain.com

What you'll learn

  • OpenWiki is an open-source CLI tool from LangChain that generates documentation specifically for AI agents to consume, not for human readers
  • Documentation for agents looks fundamentally different from documentation for humans, requiring a different approach to writing and structuring
  • OpenWiki is built on three core ideas and leverages Google's Open Knowledge Format (OKF) for better retrieval by agents
  • Early benchmarking results from DeepSWE demonstrate that the generated documentation works effectively for AI agents
  • The team discovered that human readers also value the generated documentation, which was an unexpected finding

Frequently asked questions

What is the difference between documentation for AI agents and documentation for humans?
Documentation for agents looks completely different from human documentation. It is specifically written and structured for AI agents to understand and use, while human documentation is designed for readability and human comprehension.
How does the OpenWiki CLI work under the hood?
The CLI generates documentation by analyzing code and converting it into a format that agents can consume, using Google's Open Knowledge Format (OKF) for optimal retrieval.
What were the results of the DeepSWE benchmark evaluations?
Early results from the DeepSWE benchmarks show that documentation generated by OpenWiki works effectively for AI agents in completing tasks.
Is OpenWiki available as open source and where can you find it?
Yes, OpenWiki is open source under the MIT license and can be found on GitHub at langchain-ai/openwiki.

Topics