Troubleshooting & Diagnostics

If you encounter errors or startup issues, use the diagnostics guidelines below.

#Viewing Logs

Codey maintains detailed logs. You can inspect active logs in your platform data directory:

• macOS: ~/Library/Logs/codey/server.log
• Linux: ~/.local/state/codey/server.log
• Windows: %APPDATA%\codey\server.log

#Common Issues

#1. Permission Denied for Tools

If you receive errors when running tools (e.g. bash or file write), verify that you have not configured "deny" permissions in your project's codey.json. Update the setting to "ask" or "allow" to enable tool executions.

#2. Git Repository Requirement

Commands like /undo and /redo rely on Git snapshots of the project directory. Ensure that you have initialized git in your working folder (git init) to enable undo history.

#3. Model Rate Limits

When hitting provider limits, look at the error output details or consider switching to a cheaper model using the /models menu in the terminal UI.