Troubleshooting
Common issues and how to resolve them.
Command Not Found
Resolve 'command not found' errors when running npx or memoria commands. Learn how to fix PATH issues and verify npm installation.
Node.js Version
Fix Node.js version errors. Memoria requires Node.js 18+. Learn how to update Node.js using nvm or direct download.
Path Configuration
Troubleshoot PATH configuration problems on macOS, Linux, and Windows. Ensure your shell can find npm and npx commands.
MCP Connection
Fix MCP server connection problems with Claude Desktop, Cursor, Windsurf, and Continue. Debug configuration and connectivity issues.
Git Not Available
Fix errors when git is not found or the project is not a git repository. Memoria requires git history to analyze file dependencies.
Permission Errors
Resolve npm permission errors on macOS and Linux. Fix EACCES errors when installing or running Memoria.
Configuration Files
Fix configuration file issues including JSON syntax errors, wrong file locations, and invalid settings for Memoria.
Performance Issues
Speed up Memoria in large repositories with 100k+ files. Configure caching, adjust thresholds, and optimize git operations.
Still Having Issues?
If you're still experiencing problems:
- Check GitHub Issues for known problems
- Open a new issue with:
- Your OS and version
- Node.js version (
node --version) - AI tool and version (Cursor, Claude Code, etc.)
- Error message and steps to reproduce