Connect your repository

Lyra ships every post as a pull request into your own GitHub repository, so she needs access to the repo where your blog lives. You connect it with the Lyra GitHub App, not a personal access token. Connecting is a dashboard task, not a blocker, so you reach your dashboard first and connect when you are ready.

Lyra opens ready-to-merge PRs into this repo and learns how you write. Nothing auto-publishes; you merge.

Prerequisites

• A git-based blog: Markdown files with frontmatter in a GitHub repository. If your blog is on a hosted CMS, see Is your blog Lyra-ready? first.
• Permission to install a GitHub App on that repository or organization.

Connect a repo

1. On the dashboard, find the Connect your repo card, or go to Settings > Repository.
2. Click Install GitHub App.
3. Approve the app for the repositories you want Lyra to use. You can grant one repo or several.
4. Return to Lyra and pick a repo from the list. Each entry shows whether it is public or private and its default branch.
5. Click Select.

If the app is already installed, use Already installed? Pick a repo to skip straight to the picker.

Scoping

After you select a repo, Lyra scopes it. Scoping is how she learns your blog before writing a word:

1. She clones the repository.
2. She scans it to find your blog directory, file format, and frontmatter.
3. She generates a per-repo writing guide that captures your structure and voice.

You see the status move through "Cloning", "Reading", and "Mapping your repository". When scoping finishes, Lyra is ready to write.

The writing guide

The writing guide is the set of instructions Lyra follows for this repo: where posts go, the file format, and your blog's voice profile. Lyra stores it in your repo as a CLAUDE.md file.

In Settings > Repository, the Writing guide card lets you:

• View the guide.
• Edit it to correct anything about your format or voice.
• Download it.

Editing the guide changes how the writer and reviewer work on future posts.

Re-scope

Re-scope when your repo changes in a way Lyra should learn, such as a new blog directory or a reformatted template.

1. Go to Settings > Repository.
2. Click Re-scope.
3. Confirm. Re-scoping regenerates the writing guide.

Disconnect or switch repos

In Settings > Repository you can:

• Disconnect the current repo. The GitHub App stays installed on your GitHub account, so you can reconnect later without reinstalling.
• Connect a different repo to point Lyra at another repository.

How Lyra uses the repo

Once connected, Lyra works entirely through standard GitHub objects:

• She commits each post to its own branch.
• She opens a pull request labeled blog.
• She opens issues and posts resolvable review comments.
• She tags your reviewer to merge.

Everything Lyra produces lands in your repo for you to review. See Reviewing and merging.

What's next

• Add your Claude key: The credential that powers writing.
• Configure your website: Set your focus, keywords, and tracked links.
• Writing posts: Trigger and follow a post.
• Reviewing and merging: Read the PR and merge.

Troubleshooting

Issue: My repo is not in the list

Symptoms: The repo picker does not show your repository.

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

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

Issue: Scoping is stuck

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

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

Resolution: Wait for the scan to finish. If it does not complete, use Re-scope to run it again.