“BeeRad”
ad07fcb868
- Allow comma-separated clients for setup, print-config, and install-rules - Add --install-rules to setup so MCP config and agent memory install together - Document the Claude Code plus Codex one-command demo path 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 + 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
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.