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.

A Pull Request Review Did Not Start

Confirm that the comment was added to a pull request rather than a regular GitHub issue and that it is a new comment containing @ACA. Editing an existing comment does not start the agent.

Also confirm that the team has completed onboarding and that the Autonomous Coding Agent GitHub App can access the repository. If these checks pass, contact support with a link to the pull request and the trigger comment.

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.