The Linear integration is available on Pro and Enterprise plans.
Connect your Linear workspace
- Open the agent panel in your dashboard.
- Click the Settings button.
- In the Linear integration section, click Connect.
- Follow the Linear prompts to authorize the Mintlify app in your workspace.
Use the agent in Linear
Once connected, mention@mintlify in any Linear issue or comment to trigger a documentation update. The agent reads the issue context, including the title, description, and comment thread, then opens a pull request with the proposed changes.
You can use the agent in Linear to:
- Update docs from feature issues: When a feature ships, mention the agent in the issue to draft or update the relevant documentation.
- Act on documentation feedback: Create Linear issues for documentation improvements and mention the agent to make the changes.
- Generate release notes: Mention the agent in a release-related issue to draft changelog entries based on the issue details.
- Fix reported problems: When someone reports a docs issue in Linear, mention the agent to resolve it.
Example prompts
Use these examples as a starting point for your own prompts:@mintlify Update the authentication docs to reflect the new OAuth flow described in this issue.@mintlify Add a troubleshooting section to the setup guide based on the problems listed here.@mintlify Draft a changelog entry for this feature.
Best practices
- Include context in the issue: The agent uses the issue title, description, and comments to understand what to document. The more context you provide, the better the result.
- Be specific: Tell the agent exactly what you want documented and where it should go.
- Review pull requests: Always review the pull requests that the agent creates before merging them.
- Iterate in comments: Reply in the same issue thread to refine the agent’s output, similar to how you would in Slack.