“BeeRad”andClaude
5c480b01d6
- Rename Tools & Workflows to Tools & Guides - Fix merge conflict in 4_tools-and-guides.md - Update tool count and feature descriptions 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
83 lines
2.8 KiB
Markdown
83 lines
2.8 KiB
Markdown
# 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](https://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:
|
|
|
|
```json
|
|
{
|
|
"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](./2_schema.md) | Database schema, node/edge structure |
|
|
| [Tools & Guides](./4_tools-and-guides.md) | Available MCP tools, guide system |
|
|
| [UI](./6_ui.md) | Component structure, panels, views |
|
|
| [MCP](./8_mcp.md) | External agent connector setup |
|
|
| [Troubleshooting](./TROUBLESHOOTING.md) | Common issues and fixes |
|