Files

T

“BeeRad” 21772fcba7 feat: add frictionless RA-H OS setup

- Add MCP setup, doctor, init-db, config, and rules CLI commands
- Publish latest MCP package wiring and local setup helper
- Update OS install docs for MCP-only, full app, and demo-safe setup

Generated with Claude Code

2026-04-21 08:29:31 +10:00

2.7 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:

Use the MCP quick install below if you mainly want agent access.
Use the local app quick start if you also want the browser UI.
Read Full Local if you want a more local-first or community setup.

MCP Quick Install

npx -y ra-h-mcp-server@latest setup --client claude-code --yes

Run doctor after setup or whenever MCP feels stale:

npx -y ra-h-mcp-server@latest doctor

Local App Quick Start

git clone https://github.com/bradwmorris/ra-h_os.git
cd ra-h_os
npm install
npm run setup:local
npm run dev

Open http://localhost:3000

MCP Integration

The recommended MCP setup is the CLI command above. Manual config is only for troubleshooting or unsupported clients:

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

If you need a frozen version for release/debug work, pin it intentionally and restart the client.

The setup command creates the default database if it does not exist. 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.7 KiB Raw Blame History