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

34 pointsposted 10 hours ago
by handfuloflight
(github.com)

9 Comments

felixlu2026

31 minutes ago

generating docs is the easy part. keeping stale docs from becoming “truth” is the real problem.

rrvsh

7 hours ago

maintaining an LLM wiki has been a lot more effort than I thought, at least if we are trying to maintain a high quality in structure and writing comprehension (for easier lookups both for the agent and human). Are people just shotgunning their agent wikis or how

bad_username

2 hours ago

> maintaining an LLM wiki has been a lot more effort than I thought

Same here. Wikis start out good, but either devolve in a journal-y mess after a while and many updates, or require constant expensive rewrites. (I didn't use the software of the OP.)

TeeWEE

3 hours ago

This is mostly a thin clintypescript wrapper around the prompts.

This could have been a SKILL

dcreater

8 hours ago

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

b212

5 hours ago

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.

_pdp_

7 hours ago

This is what we do. The same agent writing the code can also write the docs.

mthoms

2 hours ago

We need to make an effort to distinguish “this is a thing for humans” vs “this is a thing for bots” in our naming IMHO. In that respect, “open wiki” is not such a great name. “Agent Wiki” or similar would be better.

Without such a qualifier, “wiki” carries a strong connotation of (usually collaborative) human involvement. That’s literally what it’s famous for.

Thats just my $0.02 on the naming. I definitely think it’s a worthwhile idea. All the best.