Skip to main content

Knowledge Pages

Synth stores project memory as Markdown pages under the project knowledge/ directory. The web editor lets you inspect, create, update, and delete those pages safely.

When To Edit​

Edit a page when:

  • the source was correct but the summary needs cleanup
  • you want to add a durable note
  • an Explore result exposed missing context
  • an AI agent needs a runbook or gotcha captured for next time

Keep Pages Agent-Friendly​

Good pages are short, specific, and citable.

# Auth Refresh Gotcha

Route guards can run before token refresh completes.

Read with:
- Token Refresh Strategy
- Browser Storage Race

API​

The knowledge API supports tree, read, save, create, delete, and list operations under /api/knowledge/*. Use the web editor first; use the API for automation after you know the page path.

Rule Of Thumb​

If you wished the agent had known it, make it a page.