Files

T

“BeeRad”andClaude Opus 4.5 f383d770ca docs: update documentation for RA-H Light

- Rewrite 0_overview.md for 2-panel UI + MCP focus
- Delete 1_architecture.md (agent hierarchy no longer applies)
- Delete 3_context-and-memory.md (agent context no longer applies)
- Rewrite 4_tools-and-workflows.md for MCP tools only
- Rewrite 6_ui.md for 2-panel layout
- Delete 7_voice.md (voice removed)
- Update 8_mcp.md with correct tool list (11 tools)
- Rewrite 9_open-source.md for RA-H Light
- Update README.md with new doc structure

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-29 16:06:54 +11:00

2.8 KiB

Raw Blame History

RA-H Light Overview

What is RA-H Light?

RA-H Light is a minimal knowledge graph UI with MCP server integration. It provides a local-first knowledge management system designed to be extended by external AI agents via the Model Context Protocol.

Open Source: github.com/bradwmorris/ra-h_os

Design Philosophy

Local-first — Your knowledge network belongs to you. Everything runs locally in a SQLite database you control.

Agent-agnostic — No built-in AI chat. Instead, RA-H Light exposes an MCP server that any AI agent (Claude Code, custom agents) can connect to.

Simple & focused — 2-panel UI for browsing and editing your knowledge graph. No bloat.

Tech Stack

Frontend: Next.js 15, TypeScript, Tailwind CSS
Database: SQLite + sqlite-vec (vector search)
Embeddings: OpenAI (BYO API key)
MCP Server: Local connector for Claude Code and external agents

What's Included

2-panel UI (nodes list + focus panel)
Node/Edge/Dimension CRUD
Full-text and semantic search
MCP server with 11 tools
Workflows system
PDF extraction
Graph visualization (Map view)
BYO API keys

What's NOT Included

Chat interface (use external agents via MCP)
Voice features
Built-in AI agents
Auth/subscription system
Desktop packaging

Two-Panel Layout

┌─────────────┬─────────────────────────┐
│   NODES     │        FOCUS            │
│   Panel     │        Panel            │
│             │                         │
│ • Search    │ • Node content          │
│ • Filters   │ • Connections           │
│ • List      │ • Dimensions            │
│             │                         │
└─────────────┴─────────────────────────┘

MCP Integration

RA-H Light is designed to be the knowledge backend for your AI workflows:

{
  "mcpServers": {
    "ra-h": {
      "command": "node",
      "args": ["/path/to/ra-h_os/apps/mcp-server/stdio-server.js"]
    }
  }
}

Available tools: rah_add_node, rah_search_nodes, rah_update_node, rah_get_nodes, rah_create_edge, rah_query_edges, rah_update_edge, rah_create_dimension, rah_update_dimension, rah_delete_dimension, rah_search_embeddings

Documentation

Doc	Description
Schema	Database schema, node/edge structure
Tools & Workflows	Available MCP tools, workflow system
UI	Component structure, panels, views
MCP	External agent connector setup
Troubleshooting	Common issues and fixes

2.8 KiB Raw Blame History