“BeeRad”
733d1c3407
Local-first knowledge management system with BYO API keys. Features: - 3-panel UI (Nodes | Focus | Helpers) - SQLite + sqlite-vec for vector search - Agent system (Easy/Hard mode orchestrators) - Content extraction (YouTube, PDF, web) - Integrate workflow for connection discovery - Dimension system with auto-assignment Tech stack: - Next.js 15 + TypeScript + Tailwind CSS - Anthropic (Claude) + OpenAI (GPT) via Vercel AI SDK Setup: npm install && npm rebuild better-sqlite3 scripts/dev/bootstrap-local.sh npm run dev MIT License
RA-H Scripts
Utility scripts for managing the RA-H knowledge management system.
Directory Structure
scripts/
├── database/ # Database management
│ ├── backup.sh # Create database backups
│ └── restore.sh # Restore from backups
├── helpers/ # Helper management (CRITICAL - used by API)
│ ├── duplicate-helper.js # Create new helpers
│ └── delete-helper.js # Remove helpers
└── migrations/ # Completed one-time migrations
└── cleanup-dimensions.sql
Database Scripts
Create a Backup
npm run backup
- Creates timestamped backup in
/backups/folder - Example:
rah_backup_20250902_102846.sql - Includes all nodes, chunks, edges, dimensions
Restore from Backup
npm run restore backups/rah_backup_20250902_102846.sql
- ⚠️ WARNING: Replaces entire database
- Requires confirmation before proceeding
- Shows verification after restore
List Backups
ls -lt backups/
Helper Scripts
⚠️ CRITICAL: These scripts are used by the API at runtime. DO NOT modify or delete.
Create New Helper
Called automatically by the API when creating helpers through the UI.
node scripts/helpers/duplicate-helper.js "HelperName"
Delete Helper
Called automatically by the API when deleting helpers through the UI.
node scripts/helpers/delete-helper.js "helper-id"
What Gets Backed Up
- All nodes (42,000+ knowledge items)
- Content chunks and embeddings
- Node connections/edges
- Dimensions and metadata
- Database schema and indexes
Notes
- Backups typically ~250MB for 40k+ nodes
- Store backups safely - they contain your entire knowledge base
- Helper scripts are integrated with the application - modify with caution