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.
Delegate your request to a specifc 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.
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:
A new comment on a Linear issue will start a new session with Blocks. Replying to a Blocks comment will continue the conversation in the same session.
Blocks Response Process
- Acknowledgment: Blocks will add 👀 (eye) emojis to indicate it has seen your message
- Dashboard Link: Blocks responds with a link to the dashboard where you can track progress
- Progress Updates: Blocks provides a realtime snippet about what it is currently working on
- Final Message: Blocks responds with a final message which summarizes what it did
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
@blocksagain with additional questions or clarifications