Troubleshooting

Most problems have a one-line fix. Start with the list below.

Common problems

ProblemFix
A job stays QueuedCheck runs-on. Every label must match, for example [self-hosted, codemany]. A typo keeps the job waiting.
Jobs wait a long timeEvery machine is running as many jobs at once as it can. Jobs run when one finishes. To run more at once, add a machine.
Jobs stop when the Mac sleepsKeep a laptop plugged in, or use an external display when the lid is closed. Low Power Mode also lets it sleep.
"Plan ended" or "Your trial has ended"Choose Renew Plan… in the app (Plan & Billing). Jobs already running finish.
GitHub disconnectedSign in to GitHub again in the app. Running jobs keep going; Codemany retries every 5 minutes.
"Low disk space"Free up disk space. Each job needs about 15 GB, and Codemany keeps 20 GB free for the system.

Check its health

In Terminal, run:

codemany doctor

It checks Codemany's background service, your plan, GitHub and the runners, and says what is wrong. In the app, open Settings › Troubleshooting (Linux: This machine › Troubleshooting). There you can restart the background service, Export Diagnostics…, Show App Logs in Finder, or choose Run Setup… to go through setup again. To set up with a GitHub token instead of signing in, paste it under GitHub token for setup.

Send Feedback

Choose Send Feedback… in the Codemany menu bar menu (Linux: the tray menu). It works even when you are signed out or Codemany's background service is down. You can also message @arpwal on X.