Back to Essays
#ai#documentation#agents#developer-tools#open-source

Announcing ted-mosby: Your Open-Source Architectural Wiki Agent

ted-mosby is officially available on npm. Generate comprehensive, traceable architectural documentation for any codebase.

Yesterday I wrote about agent-generated architectural wikis and the emerging category of tools that automatically document codebases. Today, I'm happy to announce that my open-source entry is ready for you to try.

ted-mosby is now available on npm.


See It In Action

I ran ted-mosby against Andrej Karpathy's nanoGPT repository. You can explore the generated wiki here:

nanochat wiki demo

The output includes architectural overviews, component breakdowns, and documentation designed for both human reading and agent consumption. Every section traces back to the source code that supports it.


Why I Built This

DeepWiki and CodeWiki are excellent, but I wanted an open-source alternative that developers can run locally, customize for their needs, and integrate into existing workflows. ted-mosby is built with the Claude Agent SDK, so it's essentially a specialized Claude Code agent focused entirely on documentation generation.


Get Started

BASH
npm install -g ted-mosby
cd your-project
ted-mosby generate

That's it. Point it at a codebase, and it generates comprehensive architectural documentation.

I'm confident this will provide real value in your programming workflow, whether you're onboarding to a new project, trying to understand a complex open-source repo, or giving your coding agents better context.

Give it a try and let me know what you think. Contributions and feedback are welcome on the npm package page.