Troubleshooting

Fixes for the issues that come up most. Each entry lists the symptom, the likely cause, and what to do. If none of these solve it, contact the team at info@trylyra.ai.

Account and access

Issue: The verification email never arrives

Symptoms: No 6-digit code after signing up.

Diagnosis: The email is filtered.

Resolution: Check spam and promotions, mark the message "Not spam", and use Resend after the cooldown.

Issue: I am stuck on the access list

Symptoms: You verified your email but cannot reach the dashboard.

Diagnosis: Your access request is still pending in the controlled rollout.

Resolution: Wait for Lyra's access-granted email, then sign back in. If you were invited to a project, accept the invitation instead.

Repository

Issue: My repo is not in the picker

Symptoms: The repository is missing from the list.

Diagnosis: The Lyra GitHub App is not installed on that repo.

Resolution: Click Install GitHub App, grant access to the specific repository, then reopen the picker. See Connect your repository.

Issue: Scoping is stuck

Symptoms: The status stays on "Cloning" or "Reading".

Diagnosis: A large repo takes longer, or a transient error occurred.

Resolution: Wait for the scan to finish, then use Re-scope if it does not complete.

Writing

Issue: Write now is disabled

Symptoms: The Write now button is greyed out.

Diagnosis: Agents are paused, the repo is not connected, or you reached your monthly post limit.

Resolution: Resume agents in Settings > Agents, connect a repo, or review usage in Billing.

Issue: A run failed

Symptoms: A topic or run shows a failed or errored state.

Diagnosis: A transient error, or a Claude rate limit.

Resolution: Use Retry or Write now on the post, or Restart on the run. See below for rate limits.

Issue: Nothing runs and the dashboard shows Key refused

Symptoms: A Key refused chip appears at the top of the dashboard, and you got an email saying Lyra stopped.

Diagnosis: Anthropic refused the website's Claude key.

Resolution: Click the chip, then Add a working key or Check the key again. See When your key stops working.

Issue: Planning says Claude could not run

Symptoms: A planning run in Activity says it could not reach Claude.

Diagnosis: Your Anthropic balance ran out, or your key is no longer accepted.

Resolution: Top up your Anthropic balance or add a working key in Settings > API keys. See Add your Claude key.

Issue: Runs pause with a rate limit

Symptoms: Posts stop and a run reports a rate limit.

Diagnosis: Your Claude account hit its rate limit.

Resolution: Lyra paces herself and hibernates the project briefly, then resumes on her own. To raise the ceiling, adjust the limits on your Anthropic account. See Add your Claude key.

Reviewing and merging

Issue: A post has a merge conflict

Symptoms: The PR shows "Open, merge conflict" or "Conflict, needs a human".

Diagnosis: Your blog directory changed after Lyra opened the PR, and she could not resolve the conflict herself.

Resolution: The post keeps its Merge button and says what is wrong. Open the pull request on GitHub, resolve the conflict against your default branch, then press Merge in Lyra again. If the post says the merge simply did not finish, press Merge again. See Reviewing and merging.

Issue: A post is stuck in review

Symptoms: The post keeps iterating and never reaches Ready.

Diagnosis: Lyra cannot clear the score bar within the maximum iterations.

Resolution: The post moves to Needs human and appears in the Needs you queue. Open it and click Decide what's next: Keep improving buys one more writing pass, and Good enough, publish it moves it to ready to merge. You can also Start over. See When a post does not clear review.

Analytics

Issue: The Search tab shows "coming soon"

Symptoms: The Google Search Console tab is not available.

Diagnosis: Your deployment has the tab masked, or you have not connected Google.

Resolution: Connect Google Search Console from the tab. The SEO and backlinks tab is always available. See Analytics.

Issue: An SEO Copilot fix was skipped

Symptoms: A fix card says it was skipped or could not be made.

Diagnosis: Lyra could not finish the change, and the card says why.

Resolution: If trying again could help, the card has a Retry button. See When a fix cannot be made.

Issue: The SEO Copilot has no data

Symptoms: The SEO Copilot page stays on "Connect Search Console and Lyra starts reporting".

Diagnosis: Search Console is not connected, or the site was connected so recently that a week of data does not exist yet.

Resolution: Connect Google Search Console from Analytics, then wait for the first completed week or use Run this week now. See SEO Copilot.

Billing

Issue: I cannot manage billing

Symptoms: The Billing page is empty or missing options.

Diagnosis: You are not the workspace owner, or billing is not configured.

Resolution: Only the owner can manage billing. Confirm your deployment has Stripe configured. See Billing.

Issue: The dashboard says Payment due

Symptoms: The automation chip reads Payment due, and nothing new runs on a website.

Diagnosis: The website's plan or extra-website fee could not be charged.

Resolution: Pay the open invoice from Billing, or update your card. Lyra resumes on her own once it lands. See When a payment fails.

Issue: Writing stopped mid-month

Symptoms: New posts will not start and usage looks full.

Diagnosis: You reached your plan's monthly post limit.

Resolution: Wait for the cycle to reset, add an extra-posts pack, or upgrade. See Add-ons.

Still stuck?

Contact the team at info@trylyra.ai, or talk to the founder.

What's next

• FAQ: Common questions answered.
• Getting started: Set up from scratch.
• The pipeline: How a post moves through the system.