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: 
@blocks search only in 'backend-api' and 'auth-service' for...

​
Example Use Cases

@blocks find all places where we're using the old authentication API across all repos
Blocks searches all connected repositories and returns matching files, line numbers, and links.

​
Coordinated changes

@blocks update the user model interface in both the backend and frontend repos to add the new 'role' field
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 explain how the user authentication flow works from the React frontend through the API gateway to the auth service
Blocks traces code paths across repository boundaries and explains how the services interact.

​
Consistency checking

@blocks check if our error handling patterns are consistent between the backend and frontend repos
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:
@blocks search only in 'backend-api' and 'auth-service' repos for...
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