Beta

Current Status

RA-H is currently distributed to a small group of beta testers as a standalone local bundle (self-contained Next.js server).

Platform: macOS only (Apple Silicon + Intel) Distribution: Direct download ZIP file (~205MB) Roadmap: Native Mac app coming soon with automatic data migration

System Requirements

• Mac: Apple Silicon (M1/M2/M3) or Intel Mac
• OS: macOS 12 (Monterey) or later
• Browser: Any modern browser (Chrome, Safari, Firefox, Edge)
• API Keys: Already embedded - no setup required!

Installation

First-Time Setup

1. Download the ZIP file from the beta distribution link
2. Extract by double-clicking (creates a local-app folder)
3. Move the folder to your preferred location:
   • Recommended: /Applications/RA-H/ or ~/Applications/RA-H/
   • Anywhere works - just remember where you put it
4. Right-click on start.command and select "Open"
   • macOS will warn about unidentified developer
   • Click "Open" anyway (one-time security prompt)
5. Browser launches automatically to http://127.0.0.1:39555
6. No API keys required - already embedded in beta bundle

Where Your Data Lives

Database location: ~/Library/Application Support/RA-H/db/rah.sqlite

Your data is stored separately from the app bundle, so:

• Data survives app updates
• You can replace the app folder without losing anything
• Migration from beta to Mac app will be automatic

Backing Up Your Data

Optional backup (recommended weekly):

cp ~/Library/"Application Support"/RA-H/db/rah.sqlite \
   ~/Library/"Application Support"/RA-H/db/rah.sqlite.backup-$(date +%Y%m%d)

Updating to New Versions

When a new beta version is released:

1. Stop the app (Ctrl+C in Terminal)
2. Download new ZIP file
3. Replace your local-app folder with the new one
4. Launch the updated app (double-click start.command)
5. Data preserved automatically (separate location)

Using RA-H

Core Features

• 3-Panel Interface - Nodes list | Focus workspace | AI conversation
• Easy/Hard Mode - Toggle between GPT-5 Mini (⚡ fast) and Claude Sonnet 4.5 (🔥 deep)
• Smart Organization - Multi-tag dimensions instead of folders
• Memory System - Auto-extracts insights from your conversations
• Workflows - Run "integrate workflow" to find connections across your knowledge base
• Content Extraction - YouTube videos, websites, PDFs automatically processed

Keyboard Shortcuts

• Cmd+K - Quick search
• Esc - Close panels
• Tab - Navigate between tabs

Troubleshooting

App Won't Start

"Permission denied" error:

chmod +x start.command

Then right-click → Open

"Port already in use" error:

• Another instance might be running
• Check for Terminal windows running RA-H
• Or restart your Mac

Performance

Slow startup:

• First launch takes longer (initializing database)
• Subsequent launches are faster

High memory usage:

• Normal for AI operations
• Restart the app if it becomes sluggish

Mac App Roadmap

Planned features:

• Native macOS application
• App Store distribution (or notarized DMG)
• Auto-updates
• Menu bar icon with quick access
• Data migration: Automatic from beta bundle location

Beta → Mac app transition:

• Mac app detects existing beta database
• Copies to Mac app location (if different)
• Runs schema migrations if needed
• You continue seamlessly with all your data

Privacy & Security

• Local Data - All your data stays on your machine
• API Calls - Only Anthropic/OpenAI/Tavily calls go over network
• No Telemetry - We don't collect usage data
• API Keys - Beta bundles use embedded keys (shared among beta users)

Known Limitations

Beta bundle limitations:

• macOS only (no Windows/Linux yet)
• Manual updates (no auto-update)
• Terminal window required (can't close it)
• No app icon in Dock (just Terminal)

Resolved in future Mac app:

• Native app with proper icon
• Background service (no Terminal)
• Auto-update system
• User's own API keys

Thank you for being a beta tester! Your feedback helps make RA-H better.