ra-h-os/docs/README.md

RA-OS Documentation

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

Quick Links

Doc	Description
Overview	What is RA-OS, design philosophy
Schema	Database schema, node/edge structure
Tools & Skills	MCP tools, skill system
Logging & Evals	Debugging, evaluation framework
UI	2-panel layout, components, views
MCP	Connect Claude Code and external agents
About	What's included, contributing
Troubleshooting	Common issues and fixes
Development	Dev workflow and PR checklist
Docs Process	How to maintain docs

Getting Started

# Clone
git clone https://github.com/bradwmorris/ra-h_os.git
cd ra-h_os

# Install
npm install

# Run
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 alternatives.

Questions?

Open an issue on GitHub.