Skip to content

Use the Wiki

The Wiki is a browsable knowledge surface built from your project’s memory. It organizes what the agent has learned into concept pages, grouped by topic and linked by backlinks. This guide covers opening the Wiki, navigating it, and working with individual concept pages.

Click Wiki in the desktop sidebar. The Wiki lives at /wiki, separate from the Memory archive at /memory. If you have not run a synthesis yet the Wiki will be empty; see Trigger synthesis below.

The Wiki home page has three columns and a Most Referenced strip at the bottom.

By Topic groups all concepts under their topic tag: Architecture, Design, Decisions, Process, Patterns, or Brand. Each group shows the concept name and its source memory count. Click any concept name to open its detail page.

Updated this week shows concepts whose synthesis timestamp falls within the last seven days, ordered by recency. Use this column to catch up on what has changed.

Emerging shows orphan candidates: themes that appear repeatedly in Memory but do not yet have a concept page. Each card shows the suggested name and how many memory entries cite it. Click Synthesize page on a card to trigger synthesis for that cluster immediately.

Most Referenced is a strip of the six concepts with the highest source memory count. It appears below the three-column grid.

Use the search input at the top of the Wiki home page to filter concepts by name or TL;DR. Press Escape to clear the search. Use the topic chips below the search input to restrict the view to a single topic tag.

The topbar has a List / Graph toggle. The graph view renders concepts as nodes with edges between concepts that link to each other via [[wikilink]] syntax. Click a node to navigate to that concept’s detail page.

Click a concept name from the list, a tile in the Most Referenced strip, or a node in the graph to open its detail page at /wiki/<slug>.

The detail page shows:

  • The topic badge and the last-synthesized timestamp.
  • A TL;DR block: the one-paragraph summary the synthesis produced.
  • The body: the full concept text. Inline [[concept name]] wikilinks are clickable and navigate to the linked concept within the Wiki.
  • Sources: the memory entries the synthesis drew from, with type, project, date, and a quoted excerpt from each.
  • Linked from: other concept pages that contain a wikilink pointing to this page.
  • Related concepts: concepts the synthesis identified as related by theme.
  • A page footer showing the on-disk path (~/.ijfw/wiki/<slug>.md), the last synthesis timestamp, and the review status.

Click Edit in the topbar of a detail page to open the concept for editing. You can also click Edit this page in the page footer.

Concept pages are Markdown files on disk. The [[wikilink]] syntax is supported in the body: [[Concept Name]] renders as a link to that concept, and [[Concept Name|display text]] uses a custom label.

Click Re-synthesize from sources in the page footer, or Update from sources in the topbar, to run synthesis again for this concept using its current source memory entries. The page content is replaced with the new synthesis output. Use this after adding new memory entries that are relevant to the concept.

Click Mark as reviewed in the page footer. This records your review timestamp and updates the freshness status shown in the topbar chip row. A concept is considered stale if it has not been reviewed since its last synthesis.

The Wiki auto-syncs every 30 minutes. To run synthesis immediately, click Synthesize now in the Wiki home topbar. The button shows a spinner while synthesis is running and displays a count of new concepts when it finishes.

Synthesis reads Memory entries that have been promoted to wiki type (either automatically when their score reaches the threshold, or manually from the Memory inspector drawer), groups them by theme, and writes or updates the corresponding concept pages under .ijfw/wiki/.

The Wiki does not replace Memory. It is a derived, human-readable view on top of it.

Memory (/memory) holds the raw time-stamped records the agent wrote: decisions, patterns, observations, preferences, and session notes. The Wiki (/wiki) holds synthesized concept pages built from those records. Memory grows continuously during agent sessions; the Wiki is updated in batches when synthesis runs.

A memory entry becomes source material for the Wiki once it is promoted, either automatically when its promotion score reaches the configured threshold or manually via Promote to wiki in the Memory inspector drawer. The promotion threshold defaults to 90 and can be adjusted from the Memory settings cog.