Troubleshooting

This page covers the most common issues you may encounter when running AutoPilot, along with practical steps to resolve them. Each section links to the relevant documentation for deeper guidance.

AutoPilot does not open

If AutoPilot fails to launch, the installation may be incomplete or another instance may already be running.

1. Confirm the application is fully installed by reviewing Install AutoPilot.
2. Check whether AutoPilot is already running in the background and close any existing instance before launching again.
3. Restart your computer to clear any stale processes, then open AutoPilot again.
4. If it still does not open, reinstall using the latest installer from the download page.

Claude connection failed

A failed Claude connection usually points to invalid credentials or a network interruption during sign-in.

1. Verify your network connection is active and stable.
2. Re-enter your credentials by following Connect Claude.
3. Sign out and sign back in to refresh the connection.
4. If the failure persists, wait a few minutes and retry, as the service may be temporarily unavailable.

Codex connection failed

As with Claude, a Codex connection failure is typically caused by invalid credentials or a network problem.

1. Check that you have a working internet connection.
2. Re-authenticate by following Connect Codex.
3. Sign out and sign back in to re-establish the connection.
4. Retry after a short wait if the service is temporarily unreachable.

License key says invalid

An invalid license message generally means the key was entered incorrectly or does not match your plan.

1. Re-enter the key carefully, checking for extra spaces or transposed characters.
2. Confirm you are using the key issued for your current plan, as described in Plan and License.
3. If the key still reports as invalid, contact support to confirm your license status.

License server unavailable

AutoPilot validates your license with the license server periodically. If the server cannot be reached, an offline grace period may apply.

Even when the license server is unavailable, Free features remain available so you can continue working.

1. Confirm your internet connection is active so AutoPilot can reach the license server.
2. Wait and retry, as the server may be temporarily unavailable.
3. For more detail on how licensing works, see Plan and License.

Update is available but not installing

An update may fail to install if it was interrupted or if AutoPilot does not have what it needs to complete the process.

1. Ensure you have a stable internet connection so the update can download fully.
2. Close and reopen AutoPilot to let it retry the update.
3. Review the update process in Auto Update.
4. If the update still does not install, reinstall the latest version from the download page.

Task stuck in progress

A task may appear stuck if the agent is waiting on input or if the run was interrupted.

1. Open the task on the board and review its current state, as described in Agile Board.
2. Check whether the task is waiting for your input or confirmation before it can continue.
3. If the task is no longer progressing, move it back to an earlier column and start it again.

Usage or token limit reached

When the provider reports that a usage or token limit has been reached, AutoPilot cannot continue immediately.

In this situation, AutoPilot waits and resumes the work when it is able to, so you do not need to restart the task manually. For details on how connections and limits are handled, see Connect Claude.

How to contact support

If these steps do not resolve your issue, our support team can help.

• Visit https://autopi.ai/support to reach support.

Still stuck? Contact support.

← Back to Documentation