- Skip AI calls when no valid OpenAI key (fixes 9-13s timeout) - Add first-run modal prompting for API key - Rewrite README for first-time users - Add /api/health endpoint - Remove all Anthropic references (not used in OS) - Fix bootstrap script (dev:local → dev) - Fix next.config.js devIndicators warning - Add Node 18+ version check 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
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