Files

T

“BeeRad” 97eeb0789f feat: finalize local OpenAI key flow and MCP docs

- add server-side .env.local OpenAI key management for the open-source app
- route AI features through the preferred local key path and lazy-load embed recovery
- rewrite README and docs for current MCP setup, schema, and fully-local guidance

Generated with Claude Code

2026-04-16 14:08:37 +10:00

2.4 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	Current SQLite contract
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 and behavior guide
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. See MCP docs for the full install, verify, memory-file, and troubleshooting path.

Questions?

Open an issue on GitHub.

2.4 KiB Raw Blame History