Troubleshooting

# Find npm bin directory
npm config get prefix
 
# Add to shell profile (~/.zshrc or ~/.bashrc)
export PATH="$(npm config get prefix)/bin:$PATH"
 
# Reload
source ~/.zshrc

# Option 1: Use npx (no install needed)
npx dev-agent index .
 
# Option 2: Fix npm permissions
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
npm install -g dev-agent

# Verify you're in repository root
ls -la  # Should see .git/
 
# Check for supported files
find . -name "*.ts" -o -name "*.js" | head -10

# Check permissions
ls -la ~/.dev-agent/
 
# Clear and rebuild
rm -rf ~/.dev-agent/indexes/*
dev index .

# 1. Check if indexed
ls -la ~/.dev-agent/indexes/
 
# 2. Verify installation
dev mcp list --cursor  # or without --cursor
 
# 3. Test manually
dev mcp start --verbose

# Index the workspace
dev index .
 
# Restart Cursor

# Verify indexed
dev stats
 
# Re-index if needed
dev index .

# Check GitHub CLI
gh auth status
 
# Login if needed
gh auth login

dev gh index  # Re-index

rm -rf ~/.dev-agent/indexes/*
dev index .
dev gh index
dev mcp install --cursor

Use dev_health tool in Cursor/Claude Code

"env": { "LOG_LEVEL": "debug" }