Skip to main content

​
Getting Started

Interact with Blocks on Linear by mentioning @blocks in any issue comment with your request. Manage issues, answer questions, improve tickets with technical details from your codebase, delegate implementations, and more. Linear Blocks Integration
Delegate your request to a specific agent by mentioning the agent keyword in a slash command. Example: /claude, /codex, /gemini. If none are mentioned, the request will default to your default agent. Learn more about available agents.

​
What Blocks Can Do

Blocks can help you with a variety of tasks on Linear:
  • Answer Questions: Ask Blocks about project status, issue details, or technical questions
  • Update Tickets: Request changes to an issue such as additional details with context from your codebase
  • Create New Issues: Ask Blocks to create additional tickets based on your requirements
  • Start Implementation: Request Blocks to begin working on the current issue you’re commenting on
Blocks can work across many repos in a single request

​
Making a Request

Simply mention @blocks in any Linear issue comment followed by your request: 
@blocks create a new issue to add unit tests for this

@blocks implement this ticket, create a pr

@blocks add code examples from the relevant repository to this ticket
Session Context: Responding in a Linear comment thread will continue in the same session, preserving all context from the conversation. Starting a new comment thread on an issue will create a fresh session with no prior context.

​
Plan Mode

Start a new session in Plan Mode to create an implementation plan before making changes: 
@blocks /plan implement this feature with a focus on scalability
Plan Mode allows you to collaborate on the approach before any code is written. Learn more about Plan Mode.
Plan Mode must be started with a new session and cannot be entered once implementation has begun.

​
Blocks Response Process

  1. Acknowledgment: Blocks will add 👀 (eye) emojis to indicate it has seen your message
  2. Dashboard Link: Blocks responds with a link to the dashboard where you can track progress
  3. Progress Updates: Blocks provides a realtime snippet about what it is currently working on
  4. Final Message: Blocks responds with a final message which summarizes what it did

​
Setting a Default Linear Team

Configure a default Linear team to streamline issue creation. When set, Blocks will automatically use your default team when creating new Linear issues unless you specify a different team in your request. Setting your default team:
  1. Navigate to Settings > Integrations in the Blocks dashboard
  2. Navigate to Linear > Configure in the integrations page
  3. Select your preferred team from the dropdown
  4. Your selection is saved automatically
Once configured, all new issues created by Blocks will be assigned to your default team, making it easier to organize and track work across your organization.

​
Best Practices

  • Be Specific: Provide clear and detailed requests to get the best results
  • Use Context: Reference specific issues, PRs, or requirements when relevant
  • Check Progress: Use the dashboard link to monitor Blocks’ work on your request
  • Follow Up: You can continue the conversation by mentioning @blocks again with additional questions or clarifications

​
Next Steps

New to Blocks? Check out the Getting Started guide to learn the basics. Learn more about: