Writing posts

Lyra writes each post using your Claude key, your repo's writing guide, and your blog's voice. She writes on a schedule for planned posts, and you can trigger any topic on demand. This page covers how to start a post and follow it as it is written.

Start a post

You can trigger writing from a few places:

• Write now on a discovered or planned topic in Blogs or on the blog detail page.
• Today's focus on Overview, which starts the suggested topic.
• The scheduled sweep, which writes the posts due each day automatically.

Write now is disabled if your agents are paused, your repo is not connected, or you have reached your plan's monthly post limit.

Follow the run

Open the blog detail page to watch a post as Lyra writes it. The status badge moves through the live stages:

1. Researching
2. Writing
3. Reviewing
4. Creating PR

The Agent runs tab shows every run that touched the post, with live activity lines. Click View full log to read the output. The log reads as an account of the work: each claim's verdict in plain words, each of your posts weighed as a place to link from, and a step repeated several times shown once with a count. A stage that runs far longer than it should is flagged while it happens, so an unusually expensive post is visible before it finishes. If a run errors, use Restart on that run.

How Lyra plans a post

Before she writes, Lyra reads the pages Google already ranks for the post's keyword: what those pages cover, the questions people ask about the topic, and what Google shows at the top of the results. She plans the post to cover what searchers expect and to add at least one angle none of the top results has. Her review then checks the draft against that plan, point by point, before the post reaches you.

She also starts each post already knowing the state of your blog: what you have published, which web addresses are taken, and which of your posts are worth linking to. Every source a post cites is checked once, before writing starts, and links to your own posts are confirmed against your repo rather than your live site. That keeps each run smaller, which keeps the cost on your Claude key down.

Read the draft

The Overview tab of a post has a Brief and Article toggle.

• Brief shows what Lyra will write: the angle, the target keywords, and a numbered outline.
• Article shows the rendered draft and the hero banner, once they exist.

The right rail shows a Draft branch card before the PR exists, then a Pull request card with the PR number, state, review score, branch, and a link to view it on GitHub.

Ask for changes

Once a post is written, you can comment on any paragraph, heading, list, table, or the banner and have Lyra change just those parts. See Ask for changes.

Start over

If a draft is going the wrong direction, use Start over on the blog detail page. Lyra discards the current draft, closes the open pull request, and opens a fresh one, writing the post from scratch.

What Lyra writes with

Every post is shaped by three inputs you control:

• Your Claude key, so the run bills to your account. See Add your Claude key.
• Your writing guide, generated when Lyra scoped your repo. Every rule in it is binding, and where it disagrees with Lyra's house style on wording or formatting, your guide wins. See Connect your repository.
• Your website settings, including focus, keywords, and tracked links. See Configure your website.

What's next

• Ask for changes: Tell Lyra what to change on a finished post.
• Reviewing and merging: What happens after the draft.
• Review scores: How Lyra scores the draft.
• Activity and run logs: Read the full run history.
• Banner images: Add hero banners to posts.

Troubleshooting

Issue: Write now is disabled

Symptoms: The Write now button is greyed out.

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

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

Issue: A run errored mid-write

Symptoms: A run under Agent runs shows an error.

Diagnosis: A transient failure or a Claude rate limit.

Resolution: Click Restart on the errored run, or use Retry on the post. If your key is rate limited, Lyra resumes on her own after a short pause.

Issue: A post could not start

Symptoms: A post stops right away and says it could not be started.

Diagnosis: Something stopped the run before writing began. The post and its run log say what it was.

Resolution: Fix the cause it names, then click Retry. The post is left ready to run again rather than put in front of you for review. If your key was refused, see Add your Claude key.