Files

T

“BeeRad”andClaude Opus 4.5 e8b16e8f50 fix: update all docs with correct MCP setup (npm package)

- docs/0_overview.md - npm config instead of stdio path
- docs/README.md - npm config instead of stdio path
- docs/4_tools-and-guides.md - added standalone server to key files
- docs/8_mcp.md - already updated in previous commit

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

2026-02-02 09:53:57 +11:00

2.8 KiB

Raw Blame History

RA-OS Overview

What is RA-OS?

RA-OS 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-OS 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 14 tools
Guides system (context for external agents)
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-OS is designed to be the knowledge backend for your AI workflows:

{
  "mcpServers": {
    "ra-h": {
      "command": "npx",
      "args": ["ra-h-mcp-server"]
    }
  }
}

Add this to ~/.claude.json and restart Claude. Works without RA-OS running.

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

Documentation

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

2.8 KiB Raw Blame History