brnch.io

mx

route3.mx.cloudflare.net

route2.mx.cloudflare.net

route1.mx.cloudflare.net

ns

cameron.ns.cloudflare.com

magdalena.ns.cloudflare.com

caa

txt

cloudflare_oauth_client_publisher=6dee4c2bca1bdba68f14245ae654a56d

google-site-verification=s_OIEpr5Bv8XN-RTaPSgY1Md3CG-_aQ1xgxg5VLy8do

v=spf1 include:_spf.mx.cloudflare.net ~all

dmarc

v=DMARC1; p=reject;

# As a condition of accessing this website, you agree to
# abide by the following content signals:

# (a)  If a content-signal = yes, you may collect content
# for the corresponding use.
# (b)  If a content-signal = no, you may not collect content
# for the corresponding use.
# (c)  If the website operator does not include a content
# signal for a corresponding use, the website operator
# neither grants nor restricts permission via content signal
# with respect to the corresponding use.

# The content signals and their meanings are:

# search: building a search index and providing search
# results (e.g., returning hyperlinks and short excerpts
# from your website's contents).  Search does not include
# providing AI-generated search summaries.
# ai-input: inputting content into one or more AI models
# (e.g., retrieval augmented generation, grounding, or other
# real-time taking of content for generative AI search
# answers).
# ai-train: training or fine-tuning AI models.

# ANY RESTRICTIONS EXPRESSED VIA CONTENT-SIGNALS ARE EXPRESS
# RESERVATIONS OF RIGHTS UNDER ARTICLE 4 OF THE EUROPEAN
# UNION DIRECTIVE 2019/790 ON COPYRIGHT AND RELATED RIGHTS
# IN THE DIGITAL SINGLE MARKET.

User-agent: *
Content-Signal: search=yes, ai-input=yes, ai-train=no
Allow: /
Allow: /docs
Allow: /explore
Allow: /security
Allow: /support
Allow: /legal
Allow: /install
Allow: /receipts/
Allow: /auth.md
Allow: /.well-known/
Disallow: /v1/
Disallow: /api/
Disallow: /git/
Disallow: /oauth/
Disallow: /oidc/
Disallow: /mcp$
Disallow: /mcp/
Disallow: /a2a$
Disallow: /ingest/
Disallow: /_emulated/
Disallow: /img$
Disallow: /img?
Disallow: /avatars/
Disallow: /cli/
Disallow: /ssh$
Disallow: /auth$
Disallow: /login$
Disallow: /signup$
Disallow: /device$
Disallow: /settings/
Disallow: /new$
Disallow: /onboarding$
Disallow: /invitations$
Disallow: /invitations/
Disallow: /stars$
Disallow: /-/
Disallow: /*/-/

# AI search and fetches made on a person's request: the same public pages.

User-agent: OAI-SearchBot
User-agent: Claude-SearchBot
User-agent: PerplexityBot
User-agent: ChatGPT-User
User-agent: Claude-User
User-agent: Perplexity-User
Content-Signal: search=yes, ai-input=yes, ai-train=no
Allow: /
Allow: /docs
Allow: /explore
Allow: /security
Allow: /support
Allow: /legal
Allow: /install
Allow: /receipts/
Allow: /auth.md
Allow: /.well-known/
Disallow: /v1/
Disallow: /api/
Disallow: /git/
Disallow: /oauth/
Disallow: /oidc/
Disallow: /mcp$
Disallow: /mcp/
Disallow: /a2a$
Disallow: /ingest/
Disallow: /_emulated/
Disallow: /img$
Disallow: /img?
Disallow: /avatars/
Disallow: /cli/
Disallow: /ssh$
Disallow: /auth$
Disallow: /login$
Disallow: /signup$
Disallow: /device$
Disallow: /settings/
Disallow: /new$
Disallow: /onboarding$
Disallow: /invitations$
Disallow: /invitations/
Disallow: /stars$
Disallow: /-/
Disallow: /*/-/

# Model training: public repositories hold users' code, which is not ours to offer for training.

User-agent: GPTBot
User-agent: ClaudeBot
User-agent: Google-Extended
User-agent: Applebot-Extended
User-agent: CCBot
User-agent: Bytespider
User-agent: Amazonbot
Content-Signal: search=yes, ai-input=yes, ai-train=no
Disallow: /

Sitemap: https://brnch.io/sitemap.xml

Agentmap: https://brnch.io/.well-known/ard.json

# Brnch

> Brnch is code hosting for humans and agents: Git repositories where every change lands with proof. It records
> who wrote each change (a person, or an agent session with its human sponsor), who approved which exact revision and
> which independent checks ran, and signs a merge receipt anyone can verify offline. It works without any AI key.

Every documentation page is also served as Markdown (the links below point at it); the docs index is https://brnch.io/docs.md.

## Docs

- [Getting started](https://brnch.io/docs/getting-started.md): Create an account, install the CLI, push your first repository and bring your team and your GitHub code to Brnch.
- [Repositories](https://brnch.io/docs/repositories.md): Create, import, clone, browse, search and manage Git repositories.
- [Changes, review and merging](https://brnch.io/docs/changes.md): Propose, review, verify and merge work into protected branches, and undo it when you need to.
- [Collaboration](https://brnch.io/docs/collaboration.md): Issues, labels, your inbox and notifications, stars, profiles and activity.
- [Agents and AI](https://brnch.io/docs/agents.md): Give coding agents accountable, scoped access to your repositories, and use optional AI features without giving up control.
- [Actions](https://brnch.io/docs/actions.md): Run CI workflows on hosted or self-hosted runners and publish their results as evidence on your changes.
- [Integrations](https://brnch.io/docs/integrations.md): Connect GitHub and other services, send events to your own endpoints, and authorize apps that act for you.
- [Security](https://brnch.io/docs/security.md): Protect your account, credentials and code with passkeys, keys, tokens, secret scanning, push protection and the audit log.
- [Administration](https://brnch.io/docs/administration.md): Run an organization: members, roles and permissions, settings, exports and deletion.
- [Reference](https://brnch.io/docs/reference.md): Complete reference for the brnch CLI, the REST API, the MCP tools, limits, terms and keyboard shortcuts.
- [Changelog](https://brnch.io/docs/changelog.md): What's new in Brnch: features, improvements and fixes as they ship, newest first.

## API

- [API overview](https://brnch.io/docs/reference/api.md): How the Brnch REST API works (base URL, authentication, errors, pagination, idempotency, consistency, versioning and rate limits) and its main resources.
- [API catalog](https://brnch.io/.well-known/api-catalog): RFC 9727 linkset of the REST API (https://brnch.io/v1), the MCP server and the A2A agent
- [OAuth authorization server metadata](https://brnch.io/.well-known/oauth-authorization-server)

## CLI

- [Install the CLI](https://brnch.io/docs/getting-started/install-the-cli.md): Install the brnch command-line tool, sign in with your browser, and check that everything works.
- [CLI reference](https://brnch.io/docs/reference/cli.md): Every brnch command and subcommand with its options and an example, plus global options, environment variables, configuration and exit codes.

## MCP and agents

- [Sign in and set up (auth.md)](https://brnch.io/auth.md): how an agent gets its person signed in on Brnch and the CLI set up
- [MCP server](https://brnch.io/docs/agents/mcp-server.md): Connect ChatGPT, Claude, Claude Code and other MCP clients to Brnch with OAuth or a token, and control what they can do.
- [MCP tools](https://brnch.io/docs/reference/mcp-tools.md): The tools Brnch's MCP server offers to AI assistants and coding agents, what each one does, and how to connect.
- [Working with Brnch from a coding agent](https://brnch.io/docs/agents/working-from-a-coding-agent.md): Use Brnch from Claude Code, Codex, Cursor and other coding agents so their work is recorded as the agent, with you as its sponsor.
- [A2A agent](https://brnch.io/docs/agents/a2a.md): Let other agents search and read Brnch through the Agent2Agent (A2A) protocol, with OAuth or a token and your permissions.
- [MCP server card](https://brnch.io/.well-known/mcp/server-card.json): the server at https://brnch.io/mcp (Streamable HTTP; OAuth or a bearer token) and its tools
- [Agent skills](https://brnch.io/.well-known/agent-skills/index.json)

## Optional

- [Create an account](https://brnch.io/docs/getting-started/create-an-account.md): Sign up with a passkey or an email code, save your backup codes, and add a second factor.
- [Organizations and namespaces](https://brnch.io/docs/getting-started/organizations-and-namespaces.md): The difference between your personal account and organizations, how to create an organization, and how to switch between them.
- [Your first repository](https://brnch.io/docs/getting-started/your-first-repository.md): Create a repository in the web app or the CLI, clone it, push your first commit, and find your way around the repository page.
- [Start a new app](https://brnch.io/docs/getting-started/start-a-new-app.md): One command creates and names an app with Next.js, React, Astro or another framework, hosts it on Brnch, deploys it to Cloudflare Workers on workers.dev or your own domain, and gets your coding agent ready to work on it.
- [Import from GitHub](https://brnch.io/docs/getting-started/import-from-github.md): Connect GitHub, choose which repositories go where, import them with their history (and optionally issues and pull requests), and point your local clones at Brnch.
- [Invite your team](https://brnch.io/docs/getting-started/invite-your-team.md): Invite people to an organization by email, choose their roles, and help them accept.
- [Next steps](https://brnch.io/docs/getting-started/next-steps.md): Where to go once your account, CLI and first repository are set up.
- [Create and import repositories](https://brnch.io/docs/repositories/create-and-import.md): Create an empty repository, or import history from a Git URL, GitHub or GitLab, in the web app, the CLI or the API.
- [Clone and push](https://brnch.io/docs/repositories/clone-and-push.md): Clone over HTTPS or SSH, authenticate Git with the brnch CLI or an access token, and understand which pushes Brnch accepts.
- [Browse code](https://brnch.io/docs/repositories/browse-code.md): Navigate files, read source and blame, follow file history, link to exact lines, and compare branches in the web app.
- [Branches and tags](https://brnch.io/docs/repositories/branches-and-tags.md): List branches and tags, change the default branch, protect branches with the merge policy, and create tags.
- [Search](https://brnch.io/docs/repositories/search.md): Search code, changes, issues and comments in one repository or across an organization, and understand what the code index covers.
- [Releases](https://brnch.io/docs/repositories/releases.md): Publish release notes for a tag, save drafts, and understand what a release contains.
- [Forks](https://brnch.io/docs/repositories/forks.md): Fork a repository into your account or another organization, keep it in sync, and propose changes back.
- [Repository settings](https://brnch.io/docs/repositories/repository-settings.md): Change a repository's description, topics, default branch, visibility, picture, merge policy, collaborators and deploy keys.
- [Repository pictures](https://brnch.io/docs/repositories/repository-pictures.md): How Brnch finds a picture for each repository from its favicon or logo, and how to upload your own.
- [Archive and delete](https://brnch.io/docs/repositories/archive-and-delete.md): Make a repository read-only, delete it with a 30-day recovery window, restore it, or purge it permanently.
- [Packages: container images](https://brnch.io/docs/repositories/packages.md): Push and pull container images on the Brnch registry, build them in Actions, sign them, and manage retention and storage.
- [Open a change](https://brnch.io/docs/changes/open-a-change.md): Propose work for a protected branch from the web app, the CLI, a stack push, an agent workspace or a fork.
- [Revisions and stacks](https://brnch.io/docs/changes/revisions-and-stacks.md): How updates to a change become revisions, how to compare them, and how to build and land stacks of dependent changes.
- [Reviews](https://brnch.io/docs/changes/reviews.md): Request reviewers, approve or request changes on an exact revision, discuss in threads, suggest edits, and work with code owners.
- [Checks and evidence](https://brnch.io/docs/changes/checks-and-evidence.md): Required checks, trusted and reported evidence, readiness, and every reason a change can be blocked from merging.
- [Merge policy](https://brnch.io/docs/changes/merge-policy.md): The versioned rules every merge is judged by, how to adopt a new version, and why a change can't rewrite the rules it is judged by.
- [Merging](https://brnch.io/docs/changes/merging.md): How a ready change lands, including merge strategies, the merge queue, auto-merge (also for all your agents' changes), and what "merged" means in Brnch.
- [Undo and the operation log](https://brnch.io/docs/changes/undo-and-operation-log.md): See every branch and tag update with who made it, and undo a push or revert a merge safely.
- [Conflicts](https://brnch.io/docs/changes/conflicts.md): What happens when a change conflicts with its target, how to resolve it, how the conflict forecast warns you early, and how semantic overlap catches changes to the same function.
- [Issues](https://brnch.io/docs/collaboration/issues.md): Create issues with acceptance criteria, move them through states, mark what blocks them, assign and claim them, and comment.
- [Labels](https://brnch.io/docs/collaboration/labels.md): Create, edit and delete a repository's labels, and apply them to issues and changes.
- [Inbox and notifications](https://brnch.io/docs/collaboration/inbox-and-notifications.md): Triage your inbox, choose which repositories notify you, and choose what reaches you by email, push and in the app.
- [Stars, Explore and profiles](https://brnch.io/docs/collaboration/stars-explore-and-profiles.md): Star repositories, discover public repositories and topics, follow people and organizations, and edit your profile.
- [Activity](https://brnch.io/docs/collaboration/activity.md): Follow your feed, see every push to a repository and the agents working in it, and undo branch updates from the operation log.
- [Agent identities](https://brnch.io/docs/agents/agent-identities.md): Register an agent, set the most it may ever do, edit it, see its track record, and revoke it.
- [Delegate to a coding agent](https://brnch.io/docs/agents/delegate-to-a-coding-agent.md): Hand an issue or a change to Claude Code, Codex CLI, Cursor CLI, Gemini CLI, OpenCode or the Brnch agent, and follow its work.
- [Agent sessions](https://brnch.io/docs/agents/agent-sessions.md): Start a sponsored session for an agent, follow its live activity, and end or hand off its work.
- [Agent context and attribution](https://brnch.io/docs/agents/agent-context-and-attribution.md): See in blame and in changes which lines your agent tools wrote and why, and control what is captured.
- [Merge receipts](https://brnch.io/docs/agents/receipts.md): What a merge receipt proves, how to verify one with brnch verify or in your browser, and how to show coverage with a badge.
- [AI features](https://brnch.io/docs/agents/ai-features.md): Optional AI assists in Brnch, built-in AI or your own provider keys, what is sent to providers, and how to turn them off.
- [Coordinating several agents](https://brnch.io/docs/agents/coordinating-agents.md): See who else is working in a repository, claim ADR numbers, migration numbers, versions and locks before using them, and let agents hear about each other through their hooks.
- [ChatGPT plugin](https://brnch.io/docs/agents/chatgpt.md): Use Brnch from ChatGPT and Codex with the Brnch plugin, what it can do, what it never does, and how to revoke it.
- [The assistant](https://brnch.io/docs/agents/assistant.md): Ask the Brnch assistant from any page, approve what it proposes, and decide what it remembers about you, your organization and each repository.
- [Workflows](https://brnch.io/docs/actions/workflows.md): Write workflow files for Brnch Actions — file location, triggers, jobs, steps, expressions, built-in actions and differences from GitHub Actions.
- [Runners](https://brnch.io/docs/actions/runners.md): Choose between Brnch-hosted and self-hosted runners, register your own machines, target them with labels and groups, and control untrusted jobs.
- [Secrets and variables](https://brnch.io/docs/actions/secrets-and-variables.md): Store repository and organization secrets for Brnch Actions, use them in workflows, import secrets from Infisical, push them to Cloudflare Secrets Store and request OIDC ID tokens.
- [Runs and logs](https://brnch.io/docs/actions/runs-and-logs.md): Follow workflow runs on the Actions tab, read live logs, download artifacts, run workflows manually, and cancel or re-run runs.
- [CI assessment](https://brnch.io/docs/actions/ci-assessment.md): Get a read-only inventory of the CI configuration in a repository, to plan which checks to move to Brnch Actions or publish from your existing CI.
- [GitHub](https://brnch.io/docs/integrations/github.md): Connect a GitHub account so Brnch can import your repositories, issues and pull requests, and understand exactly what each permission is used for.
- [Webhooks](https://brnch.io/docs/integrations/webhooks.md): Send Brnch events to your own HTTPS endpoint, verify their signatures, and inspect, retry and redeliver deliveries.
- [Connected services](https://brnch.io/docs/integrations/connected-services.md): Connect Cloudflare, PlanetScale, Sentry, Datadog, Prometheus, GitHub, GitLab, Infisical and AI providers on the Integrations page, with OAuth or an API token.
- [OAuth apps and MCP clients](https://brnch.io/docs/integrations/oauth-apps.md): How apps such as ChatGPT, Claude and Claude Code get access to Brnch with OAuth, what the consent screen shows, which scopes exist, and how to revoke access.
- [Deploy to Cloudflare Workers](https://brnch.io/docs/integrations/deploy-to-cloudflare.md): Deploy a Worker or a Pages project from your protected branch, preview every change, see each deployment on the commit and the change, and roll back.
- [Cloudflare resources and D1 migrations](https://brnch.io/docs/integrations/cloudflare-resources.md): See the D1, KV, R2, Queues and other resources your Wrangler configuration binds, apply D1 migrations safely on deploy, give changes their own preview resources, and manage Worker secrets.
- [Buildkite](https://brnch.io/docs/integrations/buildkite.md): Run your Buildkite pipelines on pushes, changes and merge candidates, give agents a short-lived checkout token, and require Buildkite steps as checks.
- [Sharing connections](https://brnch.io/docs/integrations/sharing-connections.md): Connect a service once and share it down the hierarchy: from your personal account to an organization, and from an organization to its repositories.
- [AI code review (CodeRabbit, Greptile, Codex, Claude Code)](https://brnch.io/docs/integrations/ai-code-review.md): Have CodeRabbit, Greptile, OpenAI Codex or Claude Code review every change automatically. Findings become review threads and a check.
- [Database migrations](https://brnch.io/docs/integrations/database-migrations.md): Keep your migration files in the repository; Brnch lints them on every change, shows what they do to the schema, applies them to PlanetScale or Cloudflare D1 after a person's approval, and tells you when the database drifts.
- [Passkeys, two-factor authentication and sessions](https://brnch.io/docs/security/passkeys-and-mfa.md): Sign in without a password, add a second factor, keep backup codes, confirm sensitive actions and sign out devices.
- [SSH keys](https://brnch.io/docs/security/ssh-keys.md): Add SSH keys to your account, set up Git over SSH with the brnch CLI, and troubleshoot connections.
- [Commit signing](https://brnch.io/docs/security/commit-signing.md): Sign commits and tags with an SSH key so they show as Verified, and understand what Verified means.
- [Access tokens](https://brnch.io/docs/security/access-tokens.md): Create, scope, use and revoke personal access tokens for scripts, CI, Git over HTTPS and the API.
- [Secret scanning](https://brnch.io/docs/security/secret-scanning.md): How Brnch finds credentials in pushes and repository history, what it detects, how alerts work, and what it stores.
- [Push protection](https://brnch.io/docs/security/push-protection.md): Why a push was blocked for containing a secret, how to fix it, and how a repository admin allows a false positive once.
- [Deploy keys](https://brnch.io/docs/security/deploy-keys.md): Give a server or CI job SSH access to one repository without a user account.
- [Audit log](https://brnch.io/docs/security/audit-log.md): See who did what in your organization, verify that the log hasn't been changed, and check signed checkpoints.
- [Privacy and product analytics](https://brnch.io/docs/security/privacy-and-analytics.md): What usage data Brnch collects in the web app, what it never collects, and how to turn it off.
- [Members and invitations](https://brnch.io/docs/administration/members-and-invitations.md): Invite people to an organization by email, accept invitations, change roles, remove members and organize them into teams.
- [Roles and permissions](https://brnch.io/docs/administration/roles-and-permissions.md): What each organization role can do, how repository permissions and grants work, and how agents and tokens are limited.
- [Organization settings](https://brnch.io/docs/administration/organization-settings.md): A tour of every tab in an organization's settings, what it controls and who can change it.
- [Data export](https://brnch.io/docs/administration/data-export.md): Export a repository's Git data and collaboration records as a portable bundle through the API.
- [Renaming, archiving and deleting](https://brnch.io/docs/administration/account-and-organization-deletion.md): Change your handle or an organization's name, archive and delete repositories, and how long Brnch keeps data.
- [Limits](https://brnch.io/docs/reference/limits.md): Sizes, rates, lifetimes and counts that Brnch enforces, and what happens when you reach them.
- [Glossary](https://brnch.io/docs/reference/glossary.md): The terms used across Brnch, the brnch CLI and the API.
- [Keyboard shortcuts](https://brnch.io/docs/reference/keyboard-shortcuts.md): Keyboard shortcuts in the Brnch web app, globally and on each page.
- [Sitemap](https://brnch.io/sitemap.xml)

Contact: mailto:security@brnch.io
Expires: 2027-09-30T00:00:00.000Z
Preferred-Languages: en
Canonical: https://brnch.io/.well-known/security.txt
Policy: https://brnch.io/legal/security-disclosure