Troubleshooting

Common issues and their solutions. If you don't find your answer here, contact support@synthcore.dev.

Provisioning

Project stuck on "Provisioning"

If your project has been in the Provisioning state for more than 10 minutes:

1. Check the Logs tab for error messages.
2. Try deleting the project and creating a new one.
3. If the issue persists, the AWS region may be experiencing capacity issues. Try a different region.

"Insufficient permissions" error

This means Synthcore doesn't have write access to your repository:

1. Go to GitHub Settings > Applications > Synthcore.
2. Ensure the repository is in the authorized list.
3. Verify Synthcore has "Read and write" access to repository contents.

Agent Issues

Agent not committing

If your agent is running but not producing commits:

1. Check the Activity tab for research or analysis entries — your agent may be in the investigation phase.
2. Review the Logs tab for warnings or errors.
3. Verify your agent's configuration has clear priorities and a project description.
4. Check that your agent's file-access boundaries aren't overly restrictive.

Merge conflicts

Your agent is designed to handle merge conflicts automatically. If conflicts persist:

1. Manually resolve the conflict in your repo — your agent will pick up the clean state.

Agent modifying wrong files

If your agent is working outside its intended area:

1. Update your agent's configuration with stricter boundary rules.
2. Changes take effect on the next agent cycle.

Build Failures

Build fails after agent commit

Your agent monitors builds automatically. If a build fails:

1. Your agent will log a warning in the activity feed.
2. The offending commit is identified in the logs.
3. Your agent monitors builds and will attempt a fix in its next cycle.
4. If the issue persists, manually revert the commit and update your agent's priorities.

TypeScript errors

If your agent produces TypeScript errors:

1. Ensure your agent's configuration specifies "TypeScript strict mode" in the tech stack.
2. Add type-checking instructions to your agent's boundaries.
3. Check that tsconfig.json is in the repo root.

Billing

Payment failed

1. Go to Dashboard > Billing > Manage Subscription.
2. Update your payment method in the Stripe portal.
3. Stripe will retry the charge automatically.

Wrong plan

1. Go to Dashboard > Billing > Manage Subscription.
2. Change your plan in the Stripe Customer Portal.
3. Changes are pro-rated — you'll only pay the difference.

Getting Help

If your issue isn't covered here:

• Email: support@synthcore.dev
• Docs: Search these docs with Cmd+K
• Enterprise: Use your dedicated Slack channel