Live data from Hacker News

OpenWiki: CLI that writes and maintains agent documentation for your codebase

github.com

31–39 of 39 posts

Re: OpenWiki: CLI that writes and maintains agent documentation for your codebase

#31

Earlier quoted context omitted.

I recently noticed people think "wiki" is a set of deeply interlinked documents. But to me it means ability to edit without logging in.

I don't know of any wikis that let you edit without logging in. That is simply not viable, it'd be like trying to live without an immune system.

The original C2 wiki did that for two decades.

Re: OpenWiki: CLI that writes and maintains agent documentation for your codebase

#32
post #6

Earlier quoted context omitted.

I swear most of these tools are made for the sake of it… While good old prompting is often better than plan mode or superpower skills.

I've had a number of people send me tools like this at work, and easily 50% of them can't answer basic questions like "what's the reason someone would adopt this tool" or "how do you know that it will achieve its stated goals". Agents are good at reading code, I can't imagine what the point of autogenerating agent context could be if it's not showing demonstrable cost benefits.

> I can't imagine what the point of autogenerating agent context could be

I have a fork of the OpenAI Codex repo at https://github.com/gitsense/smart-codex that shows why you may want to autogenerate agent context.

I makes navigating a 4000+ file repo extremely context efficient. It is important to note that the goal is too keep the context as clean as possible and not necessary speed.

Re: OpenWiki: CLI that writes and maintains agent documentation for your codebase

#33
post #3

What does this do better than just asking your agent to "write docs" or a more robustly defined prompt/skill?

Have a look at the prompts in the GitHub [0]. It defines a System Prompt and specifies the documentation structure. This would allow you to switch coding agents, instead of relying on how your coding agent interprets the command "write docs". [0]: https://github.com/langchain-ai/openwiki/blob/main/src/agent...

That's just cruft unless there is a benchmark demonstrating it's actually better than just asking an agent to write docs and/or using one of the thousands of document-writing skills like Anthropic's doc-coauthoring.

Re: OpenWiki: CLI that writes and maintains agent documentation for your codebase

#36
post #28

Earlier quoted context omitted.

Wikipedia?

You try that in 2026 and not only is your changes getting rolled back but your IP address is likely banned in advance anyway. Though to be fair I hear that even logged in your changes get rolled back, something about "reddit style moderators power tripping". Though on the naming definition I think wiki is a good term for interlinking documents about _something_. I often associate the term wiki with game wikis, which…

Yeah, Wikipedia is famously hostile to new contributors. It's a wonder they still continue existing and also have the gall the beg for donations. Imagine if reddit begged for donations?

I don't even really think about wikis as a set of interlinked documents moreso just as a repository of information. In the context of games whose communities created wikis, at least. Usually the discoverability of and interlinking of documents in said community wikis is pretty piss-poor though.

Post reply on HN