Troubleshooting

Common issues and how to resolve them.

Installation Issues

CLI not found after install

Add the install directory to your PATH:

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

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

Permission denied during install

Run with elevated permissions:

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

Authentication Issues

Login times out

Check your internet connection and try again:

intentra auth login --timeout 120

Token expired

Re-authenticate:

intentra auth logout
intentra auth login

Hook Issues

Hooks not firing

Verify hooks are installed:

intentra hooks status

If not installed:

intentra install cursor --force

IDE not detecting hooks

Restart your IDE after installing hooks.

Getting Help

If you’re still having issues:

1. Check the status page 
2. Search GitHub issues 
3. Contact support at [email protected]