ra-h-os/CLAUDE.md

RA-OS

What This Is

Open-source, local-first knowledge graph app with MCP integration.

Core Stack

• Next.js 15 + TypeScript + Tailwind
• SQLite + sqlite-vec
• BYO API keys (OpenAI/Anthropic)

Run Locally

git clone https://github.com/bradwmorris/ra-h_os.git
cd ra-h_os
npm install
npm rebuild better-sqlite3
scripts/dev/bootstrap-local.sh
npm run dev

Source of Truth for Workflow

• AGENTS.md - agent and contributor workflow
• CONTRIBUTING.md - PR and contribution policy

Key Paths

• src/services/database/ - data layer
• src/tools/ - MCP tool implementations
• src/config/guides/ - built-in guide content
• app/api/ - API routes

Docs

• docs/README.md
• docs/0_overview.md
• docs/2_schema.md
• docs/4_tools-and-guides.md
• docs/6_ui.md
• docs/8_mcp.md