Connectors
Connectors bring data from external tools into Ruru turns. Connect GitHub and Linear, reference items using @mentions, and let models safely query external services.
Connecting services
Open Settings (⌘ + ,) > Connectors to authenticate your accounts:
- GitHub: Authenticate via personal access token or OAuth. Access repositories, pull requests, issues, and commit histories.
- Linear: Connect your Linear workspace to search issues, project initiatives, cycle tasks, and team roadmaps.
@mention syntax in composer
Type @ in the Ruru prompt composer to mention a connector:
- Typing
@gitautocompletes to@github. - Once accepted, it turns accent-colored and attaches an interactive pill to the turn.
Targeted references
You can qualify a connector mention to target a specific resource:
@github tryruruapp/ruru— attaches repository summary and recent commits.- Paste a direct GitHub issue or PR link into the composer to attach that specific thread.
@linear ENG-1284— fetches the specific Linear issue description, status, and comments.
Tool use and mutation safety
When using an Anthropic model with tool-use capability, the model can decide to query a connector mid-turn to retrieve additional information.
Strict mutation confirmation
While read queries happen transparently, any action that would modify external state (such as creating an issue, posting a PR review comment, or pushing a commit) triggers an interactive safety modal in Ruru: