This guide explains how to set up and use the Linear integration with ChatPRD, so you can automate ticket review, improve requirements, and get AI-powered help directly in your Linear workspace.
What is the Linear Integration?
The Linear integration lets you:
Automatically review and improve issue descriptions using AI
Break down large issues into actionable subtasks
Get answers to requirements questions by mentioning @chatprd in comments
Collaborate with your team using organization-level access
Requirements
You must be part of a ChatPRD organization (team integration only)
You need permission to connect integrations in ChatPRD and Linear
How to Connect Linear
In ChatPRD, go to Settings > Integrations.
Find the Linear card and click Connect Linear.
You’ll be redirected to Linear to authorize ChatPRD. Log in and approve the requested permissions.
After connecting, you’ll see your Linear workspace name and a green “Connected” status in ChatPRD.
Tip: If you see “Not Connected,” make sure you’re part of a team and on a supported plan.
What Happens After Connecting
The Linear card in ChatPRD will show your workspace name and a “Connected” badge.
You can disconnect at any time by clicking Disconnect Linear.
Only one Linear workspace can be connected per ChatPRD organization.
How to Use ChatPRD in Linear
1. When You Create a New Issue
ChatPRD will automatically post a welcome comment on the issue, explaining how to use the assistant.
2. When an Issue is Assigned
ChatPRD will post a comment introducing itself and offering to help with requirements, subtasks, or questions.
3. Mentioning @chatprd in a Comment
Type @chatprd in any comment to ask for help. For example:
“@chatprd can you improve this description?”
“@chatprd break this down into sub-issues.”
“@chatprd what’s missing from these requirements?”
ChatPRD will analyze your request and reply in the thread.
4. Continuing a Conversation
If you reply in a thread where ChatPRD has commented, it will respond to your follow-up questions or requests.
5. What ChatPRD Can Do
Improve Issue Description: Suggests a better title and a detailed, structured description.
Make Sub-issues: Breaks down the issue into actionable subtasks, each with a clear title and done criteria.
Answer Questions: Responds to requirements or clarifies the issue based on your comment.
Troubleshooting
Not Connected? Make sure you’re in a team and on a supported plan. Try reconnecting.
No Response? Make sure you mentioned @chatprd.
Error Comment? If you see an error from ChatPRD, try again or contact support.
FAQ
Can I use this on my personal account? No, you must be part of a ChatPRD organization.
What permissions does ChatPRD need? ChatPRD needs access to read and comment on issues in your Linear workspace.
How do I disconnect? Go to Settings > Integrations in ChatPRD and click Disconnect Linear. Uninstall the Linear app from your workspace.
Support
If you need help, contact us and include:
Your ChatPRD organization name
Your Linear workspace name
A description of the issue