Agent Wiki Save
Save valuable content from the current conversation to the wiki. First decide
whether you're creating a new page or updating an existing one — search
first (awiki search "<query>") so you don't create a duplicate.
New page
-
Generate a summary: Write a clean markdown summary of the content to save. Include:
- A clear
# Titleheading - Key findings, decisions, or knowledge
[[wikilinks]]to related topics if known
- A clear
-
Write to a temp file: Save the summary to a temp
.mdfile -
Ingest: Run
awiki ingest <temp-file> --topic <topic> --tags <tags> -
Report: Tell the user what was saved and where
Updating an existing page
Pages are generated from an immutable-by-convention source in raw/ — never
hand-edit a page in a topic folder. To fold a finding into an existing page:
-
Find the raw source: Run
awiki raw <page>, where<page>is the page's path (projects/my-page.md), slug or title. It prints the raw file's path, taken from the page'ssources:frontmatter. The raw name can differ from the page slug: ingest names the raw after the input file and the page after its# H1. -
Edit the raw, not the page.
-
Reingest: Run
awiki reingest <page>with the same page reference (a raw name also works). This re-renders the page from the raw; it does not author changes itself. -
Review the diff: On a normal edit-the-raw loop, reingest will stop with a divergence diff (the page's pre-edit lines differ from your edited raw). That is expected — confirm the
-lines are just the old versions of what you rewrote (not unique page-only content you'd lose), then re-run with--force. -
Report what changed.
Footgun:
reingestregenerates the page's slug from the first# H1. Changing the H1 renames the page path and orphans the old one — keep the H1 stable unless you intend to rename.Alternative:
awiki ingest <file> --updateauthors the raw externally and rebuilds, matched by basename. Use one path or the other, not both at once.
Remote vault (
awiki init --remote …): the raw lives on the server, so steps 1–2 (editingraw/<stem>.mdin place) don't apply — over the wirereingestonly re-renders the page from the server's current raw. To change content remotely:awiki show raw/<stem>.md > <stem>.md, edit it, thenawiki ingest <stem>.md --update(the client uploads the new bytes; the server rewrites the matching raw and rebuilds).
Choosing a Topic
Ask the user which topic to file under if not obvious:
projects— project-specific knowledgedecisions— architectural or technical decisionsresearch— general research findingstools— tool configurations and usage notes
Choosing Tags
Suggest relevant tags based on the content. Keep them short and lowercase.


