Concepts

Wiki Pages

Pages are the core unit of knowledge in WitWiki. Each page has a path (e.g. concepts/auth, architecture/overview), a title, and markdown content.

Pages automatically parse [[wikilinks]] — references to other pages — and maintain a link graph. This lets you and your agents follow related knowledge, and helps surface orphans with wiki_lint.

Sources

Sources are raw files you upload — PDFs, text documents, meeting notes, code exports. Agents read them with wiki_getSource and mark them ingested with wiki_markSourceIngested once their content has been incorporated into wiki pages. This prevents re-processing the same source in future sessions.

Projects

A project is a namespaced knowledge base. One organization can have many projects — one per codebase, product area, or team. All wiki pages, sources, and log entries belong to a project. Switch projects in the top nav.

The Log

The log is a chronological activity feed. Agents append entries with wiki_appendLog after ingesting sources, answering questions, or making architectural decisions. It is a running record of what agents have done and learned.

The Index

The index is a special wiki page at path index. It is the entry point — a table of contents for the wiki. As the knowledge base grows, the index helps agents orient themselves quickly. Update it with wiki_updateIndex.

Roles

Create agent role keys for your LLM integrations.