Rebuild website from scratch on Tailwind v4 + shadcn/ui

- Fresh Astro 5 project with Tailwind v4 and shadcn/ui olive preset
- All shadcn components installed (Card, Button, Badge, Separator, etc.)
- Homepage with hero, terminal demo, workflows, agents, sources, compute
- Full docs system with 24 markdown pages across 5 sections
- Sidebar navigation with active state highlighting
- Prose styles for markdown content using shadcn color tokens
- Dark/light theme toggle with localStorage persistence
- Shiki everforest syntax themes for code blocks
- 404 page with VT323 font
- /docs redirect to installation page
- GitHub star count fetch
- Earthy green/cream oklch color palette matching TUI theme

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

website/src/content/docs/tools/alphaxiv.md

@@ -1,40 +1,48 @@
 ---
 title: AlphaXiv
-description: Paper search and analysis tools
+description: Search and retrieve academic papers through the AlphaXiv integration.
 section: Tools
 order: 1
 ---
 
-## Overview
+AlphaXiv is the primary academic paper search and retrieval tool in Feynman. It provides access to a vast corpus of research papers, discussion threads, citation metadata, and full-text PDFs. The researcher agent uses AlphaXiv as its primary source for academic content.
 
-AlphaXiv powers Feynman's academic paper workflows. All tools require an alphaXiv account — sign in with `feynman alpha login`.
+## Authentication
 
-## Tools
+AlphaXiv requires authentication. Set it up during initial setup or at any time:
 
-### alpha_search
+```bash
+feynman alpha login
+```
 
-Paper discovery with three search modes:
+Check your authentication status:
 
-- **semantic** — Meaning-based search across paper content
-- **keyword** — Traditional keyword matching
-- **agentic** — AI-powered search that interprets your intent
+```bash
+feynman alpha status
+```
 
-### alpha_get_paper
+You can also manage AlphaXiv auth from inside the REPL with `/alpha-login`, `/alpha-status`, and `/alpha-logout`.
 
-Fetch a paper's report (structured summary) or full raw text by arXiv ID.
+## What it provides
 
-### alpha_ask_paper
+AlphaXiv gives Feynman access to several capabilities that power the research workflows:
 
-Ask a targeted question about a specific paper. Returns an answer grounded in the paper's content.
+- **Paper search** -- Find papers by topic, author, keyword, or arXiv ID
+- **Full-text retrieval** -- Download and parse complete PDFs for in-depth reading
+- **Citation metadata** -- Access citation counts, references, and citation chains
+- **Discussion threads** -- Read community discussions and annotations on papers
+- **Related papers** -- Discover connected work through citation graphs and recommendations
 
-### alpha_annotate_paper
+## How it is used
 
-Add persistent local notes to a paper. Annotations are stored locally and persist across sessions.
+You do not invoke AlphaXiv directly in most cases. The researcher agent uses it automatically during workflows like deep research, literature review, and peer review. When you provide an arXiv ID (like `arxiv:2401.12345`), Feynman fetches the paper through AlphaXiv.
 
-### alpha_list_annotations
+AlphaXiv search is especially powerful when combined with citation chaining. The researcher agent can follow references from a relevant paper to discover foundational work, then follow forward citations to find papers that built on it. This produces a much more complete picture than keyword search alone.
 
-Recall all annotations across papers and sessions.
+## Configuration
 
-### alpha_read_code
+AlphaXiv configuration is managed through the CLI commands listed above. Authentication tokens are stored in `~/.feynman/auth/` and persist across sessions. No additional configuration is needed beyond logging in.
 
-Read source code from a paper's linked GitHub repository. Useful for auditing or replication planning.
+## Without AlphaXiv
+
+If you choose not to authenticate with AlphaXiv, Feynman still functions but with reduced academic search capabilities. It falls back to web search for finding papers, which works for well-known work but misses the citation metadata, discussion threads, and full-text access that AlphaXiv provides. For serious research workflows, AlphaXiv authentication is strongly recommended.