Skip to main content
Blocks can search, analyze, and make changes across multiple repositories in a single session. It automatically identifies relevant repositories from your workspace, the platform you’re using (GitHub, GitLab, Bitbucket, Slack, Linear), and any repo names you mention explicitly. When in doubt, being explicit is always faster:

​
Example Use Cases

Blocks searches all connected repositories and returns matching files, line numbers, and links.

​
Coordinated changes

Blocks modifies files across repositories and opens a separate PR in each. All PRs created in the same session are linked to that session for easy tracking.

​
Architecture analysis

Blocks traces code paths across repository boundaries and explains how the services interact.

​
Consistency checking

Blocks identifies inconsistencies across repos and suggests a unified approach.

​
Repository Context in Different Platforms

​
In GitHub, GitLab, or Bitbucket

When you mention @blocks in an issue or PR, Blocks has access to the current repository by default. You can reference other connected repos explicitly, and Blocks can create PRs in any accessible repo.

​
In Slack

All connected repos are in scope. Best for cross-repo questions and status updates.

​
In Linear

All connected repos are in scope. Blocks can create PRs across repos and reference them back in the Linear issue.

​
Limitations

​
Permissions

Blocks can only access repositories you’ve explicitly granted access to. In organization workspaces, permissions are managed at the workspace level.

​
Performance

Large operations across many repos take longer. Narrow the scope with explicit repo names or more specific queries if you need faster results.

​
Coordinating PRs

When Blocks creates multiple PRs for a single change, review them together before merging. Use Plan Mode for complex multi-repo changes where you want to confirm the approach first.

​
Troubleshooting

Grant Blocks access to the repository:
  1. Go to Dashboard → Settings → Integrations
  2. Select your provider (GitHub, GitLab, or Bitbucket)
  3. Click “Configure” to add more repositories and approve permissions
Be explicit about which repos to search:
Narrow the scope:
  • Specify which repositories to work with
  • Break large operations into smaller chunks
  • Use more specific queries to reduce search space

​
Next Steps

Getting Started

Learn the basics of using Blocks

Plan Mode

Plan complex multi-repo changes before implementing

Organization Workspaces

Manage team access to multiple repositories