Publishing your brain

Share your brain as a static website with graph view, search, and an agent-queryable API.

graph LR
    Brain["brain/"] --> Quartz["Quartz build"]
    Quartz --> Site["Static site"]
    Quartz --> API["agent.json"]
    Site --> Humans["Humans browse"]
    API --> Agents["Agents query"]

Preview locally

In Claude Code, say:

Publish my brain

Or manually:

git clone --depth=1 https://github.com/jackyzha0/quartz.git .brain-site
cd .brain-site && npm i
cp -r ../brain content/ && rm -rf content/.obsidian
npx quartz build --serve
# → http://localhost:8080

Generate the agent API after building

from distillary.agent_index import generate_agent_index
generate_agent_index("brain", ".brain-site/public")

What humans see

  • Full graph view colored by source
  • Wikilink navigation — click any [[concept]]
  • Backlinks panel on every page
  • Full-text search
  • Tag pages for filtering

What agents see

agent.json — the entry point

{
  "sources": [{"title": "The Lean Startup", "thesis": "...", "main_ideas": "/sources/lean-startup/claims/clusters/"}],
  "bridges": [{"name": "Real Signals", "description": "Reliable evidence of genuine interest", "url": "/shared/concepts/real-signals"}]
}

An agent fetches agent.json, picks the relevant bridge concept, reads its backlinks — done. Multi-source answer in 2-3 HTTP requests.

Deploy to GitHub Pages

cd .brain-site
npx quartz sync --no-pull

Your brain is now live

https://username.github.io/brain/ — browsable by humans and queryable by agents.

Sharing

python3 -c "from distillary.sharing import init_vault; init_vault('brain/')"
# Creates README + .gitignore

Community conventions

  • Tag repos distillary-brain on GitHub
  • Add domain topics (entrepreneurship, psychology, etc.)
  • Post the URL in Discord

Acknowledgments

Publishing powered by Quartz by Jacky Zhao — an open-source static site generator purpose-built for Obsidian vaults.