GitHub Integration
The GitHub integration is the native publishing path for repository-backed websites.
What it can do
Section titled “What it can do”After connection, ReachLLM can:
- Read the repository tree.
- Read existing files to learn the site's framework and content format.
- Write Markdown, MDX, HTML, or other source files.
- Commit image assets, such as generated article hero images, into the repository.
- Open pull requests by default.
- Commit directly when the brand is configured for direct publishing.
- Add or update blog posts, schema blocks, llms.txt, robots.txt, and safe GEO fixes.
How to connect
Section titled “How to connect”- Open Account > Integrations.
- Go to Content & CMS.
- Click Connect on GitHub.
- Install the ReachLLM GitHub App on the repository you want to use.
- Choose the repository and default branch.
- Keep Pull Request mode unless you want direct commits.
Select the repository that serves your public blog for article publishing. ReachLLM blocks article writes to its own app repository. That repository can still receive code fixes.
How the agent uses it
Section titled “How the agent uses it”For GitHub-backed sites, the agent should inspect the repo before writing:
- Read the repo tree.
- Open an existing post or page to copy frontmatter and formatting conventions.
- Write the complete file content.
- Add image assets to the same pull request when the content needs pictures.
- Open a pull request for review.
Generated article hero images are committed to public/images/reachllm/ by default and referenced from the article body as /images/reachllm/.... If your framework uses a different public asset folder, tell the agent the repository media directory or exact media path before uploading. For example, use media_dir: "static/uploads" for a folder or media_path: "public/assets/hero.png" for a specific file. The agent can also pass public_url when the site serves that path differently from the repository path.
For standalone image uploads, the agent uses cms_upload_media. The result includes the repository path, public URL, branch, status, and pull request URL when the upload opens a PR.
This is separate from workspace GitHub context tools. The Content & CMS GitHub connection is the publishing path.
