Back
← All features

Project knowledgeAvailable in v0.3.0

Project wiki

oah init creates docs/wiki/, an Obsidian-compatible folder where your AI keeps the task history, decisions and reasons beside the code. oah wiki maintain writes each task's log entry and index line, oah finish checks that it ran, and the next session has a record to read instead of asking you to explain everything again.

When you need it

A new AI session starts with no memory of why things were done, so you explain the same decisions again and the reasons behind older changes get lost.

How it works

  1. oah init creates docs/wiki/ with index.md (catalog by category), log.md (newest first), log_archive_NN.md files and note and decision templates.
  2. oah wiki maintain --task T writes the task's log entry and index line before the final commit, the gates and the review, and again after corrections. Running it twice adds nothing twice.
  3. oah finish only checks that it ran, and refuses with OAH_WIKI_MAINTENANCE_MISSING when it did not.
  4. Above 512,000 bytes, the oldest whole entries move to the next log_archive_NN.md; each move is journalled.
  5. oah wiki lint and oah wiki hygiene report broken links, unindexed notes, missing sources and other real problems.

Example

The folder `oah init` creates (from Concepts).

docs/wiki/
  index.md             catalog by category
  log.md               newest first, below <!-- OAH:LOG_INSERT_BELOW -->
  log_archive_NN.md    older whole entries, moved by rollover, never edited
  templates/           note and decision templates

Requirements

  • Created by oah init; nothing else to install.
  • graphify is optional (oah graph).

Limits and recovery

  • Lint and hygiene list candidates only: no wiki command deletes or moves a note on its own.
  • If a file changes during a log rollover, wiki commands stop with OAH_WIKI_RECOVERY_PENDING until you run oah wiki recover.
  • Nothing rebuilds the graphify graph automatically.
  • --allow-missing-wiki-maintenance skips the finish check and is recorded.

Original documents

Related