Files

T

“BeeRad” c0c896cf8b docs: align schema and MCP indexing guidance

- document node and chunk embedding storage
- clarify MCP context and retrieval behavior
- keep unrelated onboarding code edits unstaged

Generated with Claude Code

2026-04-20 17:07:24 +10:00

2.5 KiB

Raw Blame History

RA-H OS Documentation

 ██████╗  █████╗       ██╗  ██╗
 ██╔══██╗██╔══██╗      ██║  ██║
 ██████╔╝███████║█████╗███████║
 ██╔══██╗██╔══██║╚════╝██╔══██║
 ██║  ██║██║  ██║      ██║  ██║
 ╚═╝  ╚═╝╚═╝  ╚═╝      ╚═╝  ╚═╝

Quick Links

Doc	Description
Overview	What RA-H OS is and what contract it shares with the main app
Schema + Search	Current SQLite contract, indexing, and retrieval surfaces
Tools & Skills	MCP tools and skill system
Logging & Evals	Logs, evals, and debugging surfaces
UI	Current pane and focus model
MCP	Full standalone MCP install, behavior guide, and memory-file guidance
Open Source	Scope, support boundary, contributor reality
Full Local	Supported local path vs community patterns
Troubleshooting	Common issues and fixes

Start Here

If you just want RA-H OS working:

Read ../README.md
Follow MCP if you want external-agent access
Read Full Local if you want a more local-first or community setup

Local App Quick Start

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

Open http://localhost:3000

MCP Integration

Add to your ~/.claude.json:

{
  "mcpServers": {
    "ra-h": {
      "command": "npx",
      "args": ["--yes", "ra-h-mcp-server@2.1.2"]
    }
  }
}

If you publish a newer MCP release and need clients to use it immediately, bump the pinned version here and restart the client. Do not assume plain npx ra-h-mcp-server always refreshes instantly.

Run RA-H once first so the database exists. The standalone MCP server can write nodes without the app running, but the app owns chunking and embedding from node source: readable chunks, full-text indexes, vec_nodes, and vec_chunks. See MCP docs for the full install, verify, memory-file, and troubleshooting path.

Questions?

Open an issue on GitHub.

2.5 KiB Raw Blame History