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:8080Generate 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-pullYour 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 + .gitignoreCommunity conventions
- Tag repos
distillary-brainon 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.