Troubleshooting

This guide covers common issues and their solutions.

Installation Issues

"List Coder won't install" (Windows)

Solution:

1. Ensure you have Windows 10 x64 or later
2. Run the installer as Administrator
3. Temporarily disable antivirus if it's blocking the installer
4. Check that .NET Framework 4.7.2 is installed

"App is damaged" (macOS)

Solution:

1. Move List Coder to the Applications folder
2. Right-click → Open (bypass Gatekeeper)
3. Or run: xattr -cr /Applications/List\ Coder.app

"Permission denied" (Linux)

Solution:

chmod +x List-Coder.AppImage
# Or for .deb:
sudo dpkg -i list-coder.deb
sudo apt-get install -f

AI Issues

"AI suggestions not appearing"

Checklist:

1. Is AI enabled? → Settings → AI → Enable AI
2. Is your API key valid? → Settings → AI → API Keys
3. Is the model selected? → Settings → AI → Model
4. Restart List Coder

"Error: Rate limit exceeded"

Solution:

• Wait a few minutes and try again
• Use your own API key for higher limits
• Switch to a local model via Ollama

"Error: Model not available"

Solution:

• Check your API key has access to the model
• Try a different model (e.g., switch from GPT-4o to GPT-4o-mini)
• Ensure your account has billing set up (for paid models)

"Tab completion is slow"

Solutions:

• Reduce context window size in Settings → AI → Advanced
• Use a smaller/faster model
• Close unnecessary files
• For local models: ensure sufficient RAM/GPU

Editor Issues

"Files not saving"

Solutions:

• Check file permissions
• Ensure disk space is available
• Try Save As (Ctrl + Shift + S) to a different location
• Restart List Coder

"Syntax highlighting not working"

Solutions:

• Check the language mode in the status bar (bottom right)
• Install the language extension
• Reload the window (Ctrl + Shift + P → "Reload Window")

"Editor is lagging"

Solutions:

• Disable minimap: Settings → Editor → Minimap
• Reduce font size
• Close unused tabs
• Disable animations: Settings → Appearance → Animations

Git Issues

"Git: Command not found"

Solution:

1. Install Git from git-scm.com
2. Ensure Git is on your system PATH
3. Set the Git path in Settings → Git → Path

"Authentication failed"

Solutions:

• Use a personal access token instead of password
• Configure Git credentials: git config --global credential.helper store
• Check your GitHub/GitLab token hasn't expired

"Merge conflicts not showing"

Solutions:

• Open the Source Control panel (Ctrl + Shift + G)
• Click on the conflicted file
• Use the inline conflict resolution UI

Terminal Issues

"Terminal not opening"

Solutions:

1. Check your default shell in Settings → Terminal → Shell
2. Ensure the shell is installed (PowerShell, bash, etc.)
3. Try resetting terminal settings to default

"Commands not found in terminal"

Solutions:

• Restart List Coder after installing new CLI tools
• Check that the tool is on your system PATH
• Use the full path to the executable

Performance Issues

"List Coder is using too much memory"

Solutions:

1. Close unused tabs and panels
2. Disable extensions you don't use
3. Reduce the number of open files
4. Restart List Coder periodically

"Startup is slow"

Solutions:

• Disable auto-restoring previous session
• Reduce the number of startup extensions
• Clear the cache: Help → Clear Cache

Getting More Help

If your issue isn't covered here:

1. Search the documentation: docs.list-coder.com
2. Ask the community: list-coder.com/forum
3. Contact support: List-Enterprise@outlook.com
4. Report bugs: GitHub Issues

When reporting bugs, include:

• List Coder version
• Operating system
• Steps to reproduce
• Error messages or screenshots