Echoes can connect to your Linear instance and help you tag Linear issues with the intended outcomes and initiatives they contribute to. This allows you to express the purpose of work during the planning process in Linear and have related code contributions inherit these annotations, therefore reducing the labelling effort for engineers.

Linear integration is done through the integrations settings.

You can connect to Linear using either the OAuth flow (recommended), or providing a personal API keys generated through your Linear settings.

The installation is finalized by selecting the teams you wish to enable Echoes for.

Echoes creates labels on all teams on which it is enabled: one for each configured outcome and initiative (they will all be prefixed with Echoes: ):

You can link GitHub pull requests or GitLab merge requests to Linear issues through their branch name, the issue ID in their title, or the issue ID in their description (as described on Linear documentation). When Echoes detects a link, it will directly apply the labels it finds on both the linked issue and its parent (if any).