{"ok":true,"command":"GET /api","protocolVersion":1,"result":{"site":"joelclaw.com","owner":"Joel Hooks","description":"Personal site and agent infrastructure hub. Articles on AI agents, distributed systems, programming language theory, and developer education.","apis":{"search":{"url":"https://joelclaw.com/api/search","description":"Agent-first search across all site content. Returns HATEOAS JSON with markdown snippets.","discovery":"GET https://joelclaw.com/api/search","example":"GET https://joelclaw.com/api/search?q=voice+agent&limit=5","auth":"Optional Bearer token unlocks private collections","rateLimit":"60 req/min (Upstash)"},"docs":{"url":"https://joelclaw.com/api/docs","description":"Books, PDFs, and technical documents — chunked, searchable, with semantic search.","discovery":"GET https://joelclaw.com/api/docs","example":"GET https://joelclaw.com/api/docs/search?q=distributed+systems&perPage=3","auth":"Public read, no token required","rateLimit":"1200 req/min (Upstash)","openapi":"https://joelclaw.com/api/docs/openapi.json","ui":"https://joelclaw.com/api/docs/ui"},"piMono":{"url":"https://joelclaw.com/api/pi-mono","description":"Discovery endpoint for the public pi-mono corpus plus contributor skill install instructions.","discovery":"GET https://joelclaw.com/api/pi-mono","example":"GET https://joelclaw.com/api/search?q=Breaks+TUI&collection=pi_mono_artifacts","auth":"Public read, rate limited through /api/search"},"feed":{"url":"https://joelclaw.com/feed.xml","description":"RSS feed with full article content. All published posts.","format":"RSS 2.0 XML"}},"content":{"articles":{"description":"Long-form writing on systems, agents, and craft","url":"https://joelclaw.com","examples":["https://joelclaw.com/build-a-voice-agent-that-answers-the-phone","https://joelclaw.com/plan-9-pike-everything-is-a-file","https://joelclaw.com/propositions-as-sessions-armstrong-wadler"]},"adrs":{"description":"Architecture Decision Records — 150+ decisions documenting the system's evolution","url":"https://joelclaw.com/adrs","example":"https://joelclaw.com/adrs/0043-agent-voice-conversations"},"discoveries":{"description":"Curated finds — papers, talks, repos, tools worth knowing about","url":"https://joelclaw.com/cool"}},"agentTips":["Prefer /api/search over scraping HTML — it returns clean markdown snippets","The RSS feed at /feed.xml contains full article text, not just summaries","Every article is also available as raw MDX at github.com/joelhooks/joelclaw/tree/main/apps/web/content/{slug}.mdx","ADRs document why things were built a certain way — search them when you need architectural context","/api/docs has chunked book content with semantic search — useful for deep technical questions","/api/pi-mono documents the public pi-mono corpus and points to skill install instructions"]},"nextActions":[{"command":"curl -sS \"https://joelclaw.com/api/search\"","description":"Search API discovery (sample queries, auth details)"},{"command":"curl -sS \"https://joelclaw.com/api/docs\"","description":"Docs API discovery (books, PDFs)"},{"command":"curl -sS \"https://joelclaw.com/api/pi-mono\"","description":"pi-mono corpus discovery + install instructions"},{"command":"curl -sS \"https://joelclaw.com/api/search?q=kubernetes\"","description":"Try a search"},{"command":"curl -sS \"https://joelclaw.com/feed.xml\"","description":"Full RSS feed"}],"meta":{"service":"joelclaw-api","version":"0.1.0","cached":true}}