Troubleshooting

Use this page to help users recover from common issues.

The Agent Cannot Access My Project

Check that the project directory is available to the agent and that file permissions allow reads and writes where needed.

A Command Failed

Review the command output, confirm required dependencies are installed, and run the command manually if needed.

The Agent Made an Unexpected Change

Review the diff carefully. Revert only the affected files or hunks using your normal version control workflow, then provide the agent with a narrower task.

The Agent Needs Credentials

Do not paste secrets into documentation, issue trackers, or chat transcripts. Document the approved credential flow for your project here.

Getting More Help

Add links to support channels, issue templates, or escalation paths.