Wiki

Overview

wiki is a persistent, self-maintained markdown knowledge base for project and session knowledge. Inspired by Karpathy's LLM Wiki concept, it lets knowledge compound across sessions instead of disappearing with the chat history.

Pages live in .omc/wiki/ and are organized by category. They support cross-references via [[page-name]] wiki-link syntax.

Usage

/oh-my-claudecode:wiki

Magic keywords: wiki, wiki this, wiki add, wiki lint, wiki query

Operations

Ingest

Process knowledge into wiki pages. A single ingest can touch multiple pages.

wiki_ingest({ title: "Auth Architecture", content: "...", tags: ["auth", "architecture"], category: "architecture" })

Query

Search across all wiki pages by keywords and tags. Returns matching pages with snippets — the LLM synthesizes answers with citations.

wiki_query({ query: "authentication", tags: ["auth"], category: "architecture" })

Lint

Run health checks on the wiki. Detects orphan pages, stale content, broken cross-references, oversized pages, and structural contradictions.

wiki_lint()

Quick Add

Add a single page quickly (simpler than ingest).

wiki_add({ title: "Page Title", content: "...", tags: ["tag1"], category: "decision" })

List / Read / Delete

wiki_list()                                # Show all pages (reads index.md)
wiki_read({ page: "auth-architecture" })   # Read specific page
wiki_delete({ page: "outdated-page" })     # Delete a page

Log

View wiki operation history at .omc/wiki/log.md.

Categories

Pages are organized by category:

• architecture — system design, components, data flow
• decision — ADRs and rationale
• pattern — recurring patterns or idioms
• debugging — known gotchas, root causes
• environment — setup, deps, runtime config
• session-log — auto-captured significant discoveries

Storage Layout

.omc/wiki/
├── *.md              # Pages (markdown with YAML frontmatter)
├── index.md          # Auto-maintained catalog
└── log.md            # Append-only operation chronicle

Cross-References

Use [[page-name]] syntax to link between pages. The skill maintains the link graph and wiki_lint() reports broken references.

Auto-Capture

At session end, significant discoveries are automatically captured as session-log pages. Configure via wiki.autoCapture in .omc-config.json (default: enabled).

Hard Constraints

• No vector embeddings — query uses keyword + tag matching only
• Wiki pages are git-ignored by default (.omc/wiki/ is project-local)

Related Skills

• remember — route knowledge to the right memory surface
• learner — extract reusable skills from sessions
• writer-memory — agentic memory for writing projects

Reference