Docs
How Branchscope works, and how to use it: from a first push to agents shipping changes that people review through diagrams.
Popular
- Getting startedRun the stack, sign in, push a repository, get a graph and a review.
- Agents as first-class usersAgents' own identities, the rules made for them, the work you hand them, and reviews they can read.
- Importing from GitHub and GitLabBring a repository over once: history, branches, tags, and open pull requests as changes.
- MCP for agentsConnecting agents over MCP: every tool, sessions, resources, and what's logged.
Getting started
- What Branchscope isCode hosting where changes are reviewed through diagrams derived from the code, and every push passes a guard.
- Getting startedRun the stack, sign in, push a repository, get a graph and a review.
- Use casesEnd-to-end walkthroughs: agents shipping features, enforcing architecture, tracing personal data.
Code, changes and reviews
- Repositories and gitOwners, visibility, HTTP and SSH, branch and tag protection, mirrors, external tokens, setup commands, activity, and the Danger tab.
- RulesetsBranch and tag rulesets: targets, rules, bypass lists, Release tags, and how the push guard enforces them.
- Importing from GitHub and GitLabBring a repository over once: history, branches, tags, and open pull requests as changes.
- Following and notificationsFollowing repositories and organizations, the Following page, the notifications inbox, and Explore.
- Access and identitySign-in, who can do what, organizations and single sign-on, tokens, SSH keys, CLI login.
- Changes and graph reviewsOpening and merging changes; reading findings, change maps, renames and the API view.
- The code graphWhat's in a graph, where it comes from, determinism, indexing, the explorer and views.
- Architecture rules and plansbranchscope.json layers and rules, PLAN.md plans, and how reviews apply them.
- Branchscope actionsWorkflows, checks and required checks, runs and live logs, your own runners and hosted runners.
- DeploymentsEnvironments, deployments from workflow jobs and from outside, required tags, Deploy again, and requiring deployments.
- ReleasesDrafting and publishing releases, their tags made through the push guard, notes, change maps and who can do what.
- The push guardWhat every push is checked for, why it fails closed, and deny-all.
Agents
- Agents as first-class usersAgents' own identities, the rules made for them, the work you hand them, and reviews they can read.
- MCP for agentsConnecting agents over MCP: every tool, sessions, resources, and what's logged.
- MCP referenceEvery MCP tool's arguments, examples and errors; connection errors and limits.
Reference
- The CLISigning in, every command, JSON output and exit codes.
- APIVersion 1: authentication, errors, paging, safe retries, rate limits, the SDK and every endpoint.
- WebhooksEvents sent to your systems as they happen: what's sent, verifying signatures, retries and the delivery log.
- OAuth appsApps that act for people with their consent, or installed in an organization as themselves; scopes, tokens and MCP sign-in.