Common Issues & Solutions

# Check if Rhema is installed
which rhema
 
# If not found, reinstall Rhema
cargo install --force rhema
 
# Add Cargo bin to PATH (if needed)
export PATH="$HOME/.cargo/bin:$PATH"
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc

# Fix executable permissions
chmod +x $(which rhema)
 
# Fix project directory permissions
chmod -R 755 .rhema/
 
# Check file ownership
ls -la .rhema/

# Validate configuration
rhema config validate
 
# Reset to default configuration
rhema config reset
 
# Check configuration syntax
rhema config check

# Set required configuration
rhema config set --global project.name "my-project"
rhema config set --global editor.default "code"
 
# Initialize default configuration
rhema init --force

# Update Rust toolchain
rustup update
 
# Clean and rebuild
cargo clean
cargo build
 
# Check for dependency conflicts
cargo tree
 
# Update dependencies
cargo update

# Check dependency tree
cargo tree --duplicates
 
# Update Cargo.lock
cargo update
 
# Force resolution
cargo build --locked

# Check knowledge crate status
cargo check -p rhema-knowledge
 
# Update vector store dependencies
cargo update -p qdrant-client
cargo update -p reqwest
 
# Rebuild with specific features
cargo build --features "knowledge"

# Validate lock file
rhema lock validate
 
# Repair lock file
rhema lock repair
 
# Regenerate lock file
rhema lock regenerate
 
# Backup and recreate
cp .rhema/lock.yaml .rhema/lock.yaml.backup
rhema lock generate

# Resolve conflicts
rhema lock resolve
 
# Merge lock files
rhema lock merge
 
# Force resolution
rhema lock resolve --force

# Clear cache
rhema cache clear
 
# Validate cache
rhema cache validate
 
# Rebuild cache
rhema cache rebuild

# Optimize cache
rhema cache optimize
 
# Check cache size
rhema cache info
 
# Clean old cache entries
rhema cache cleanup

# Reinstall Git hooks
rhema git setup-hooks --force
 
# Check hook permissions
ls -la .git/hooks/
 
# Test hook execution
.git/hooks/pre-commit

# Initialize Git repository
git init
 
# Check Git status
git status
 
# Set up Git integration
rhema git setup

# Check extension installation
code --list-extensions | grep rhema
 
# Reinstall extension
code --uninstall-extension rhema
code --install-extension rhema
 
# Check extension logs
code --verbose

# Check Rhema installation
which rhema
 
# Verify PATH in editor
echo $PATH
 
# Restart editor
code --restart

# Check startup time
time rhema --version
 
# Optimize configuration
rhema config optimize
 
# Disable unnecessary features
rhema config set --global performance.lazy_loading true

# Check memory usage
rhema performance memory
 
# Optimize memory settings
rhema config set --global performance.cache_size "50MB"
rhema config set --global performance.max_memory "100MB"
 
# Clear memory cache
rhema cache clear --memory

# Check network connectivity
rhema network test
 
# Increase timeout settings
rhema config set --global network.timeout "30s"
 
# Use offline mode
rhema --offline

# Check file permissions
ls -la .rhema/todos.yaml
 
# Force save
rhema todo save --force
 
# Validate todo file
rhema todo validate

# Rebuild search index
rhema todo index --rebuild
 
# Clear search cache
rhema cache clear --search
 
# Validate search configuration
rhema config validate --search

# Check insight file
rhema insight validate
 
# Rebuild insight index
rhema insight index --rebuild
 
# Import insights from backup
rhema insight import --file insights-backup.yaml

# Enable debug logging
export RHEMA_LOG_LEVEL=debug
rhema --debug
 
# Check debug logs
rhema logs --level debug

# Full system check
rhema diagnose
 
# Check system requirements
rhema system check
 
# Generate diagnostic report
rhema diagnose --report diagnostic-report.txt

# Backup current configuration
cp -r .rhema .rhema.backup
 
# Remove Rhema configuration
rm -rf .rhema
 
# Reinitialize Rhema
rhema init --force
 
# Restore from backup (if needed)
cp .rhema.backup/todos.yaml .rhema/
cp .rhema.backup/insights.yaml .rhema/