“BeeRad”
97eeb0789f
- 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
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
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.