Troubleshooting

Common issues and how to resolve them.

Installation Issues

Add the install directory to your PATH:


export PATH="$HOME/.intentra/bin:$PATH"

Add this to your ~/.zshrc or ~/.bashrc.

Run with elevated permissions:


sudo curl -fsSL https://install.intentra.sh | sh

Verify hooks are installed:


intentra hooks status

If not installed:


intentra hooks install cursor --force

Restart your IDE after installing hooks.

Reinstall hooks to update:


intentra hooks install cursor --force
intentra hooks install claude --force
intentra hooks install gemini --force

If you see “database is locked” errors:


# Check for other intentra processes
ps aux | grep intentra
 
# Reset the database lock
intentra db unlock

Reset the local database:


# Backup existing data
cp ~/.intentra/intentra.db ~/.intentra/intentra.db.backup
 
# Reinitialize
intentra db init --force

Re-authenticate:


intentra auth logout
intentra auth login

Check sync status:


intentra sync status

Force a sync:


intentra sync push --force

If you’re still having issues: