Reos creates issues in Linear, Jira or GitHub with the account of the person who clicks, and shows their status on the initiative they belong to. An initiative groups work, its phases and the research behind it.
What you need
- The Admin or Owner role in your Reos organization.
- An account in Linear, Jira or GitHub with access to the team, project or repository where you want to create issues.
Set it up
- Go to Settings > Integrations and select Connect on Linear, Jira or GitHub. If you have not signed in to the tool yet, approve access in the window that opens.
- The details open. Choose where new issues go, then select Save:
| Tool | Dialog field | What you pick |
|---|---|---|
| Linear | Team | One team, listed as "Name (KEY)" |
| Jira | Project | One project, listed as "Name (KEY)" |
| GitHub | Repositories | One or more repositories |
Until you pick, the card says Needs attention. Open the card again to change the choice later.
Who can create issues
Each issue goes through the account of the person who creates it, and that account has to be enabled for the organization. Only admins and owners can enable an account, so in practice only admins and owners who connected and enabled their own account can create issues. Connecting a teammate's account does not connect yours.
Create or link an issue from an initiative
Open an initiative and find the phase the work belongs to. Its Tracker issues row has two buttons:
- Create issue opens Create tracker issue. Pick the Provider and, if you like, a Title (optional); without one, the title is the initiative and phase name. The issue body is built from the initiative and phase. GitHub issues go to the first selected repository.
- Link existing opens Link tracker issue. Paste an Issue URL or identifier, such as
PROJ-7or a GitHub issue URL, and select Link issue.
Linked issues show their identifier, a link to the tracker and a status badge. The initiative's own Tracker issues panel lists the issues of every phase.
To push the whole initiative to Linear, open the initiative's More options menu and select Create Linear issue. This also copies the initiative's screenshots into the issue; a screenshot that cannot be copied becomes a link back to Reos.
Create an issue from a solution
Open a solution and select Create issue, then the tracker. With several GitHub repositories, Reos asks you to Select repository first.
No tracker set up? Copy as ticket copies the solution as text you can paste anywhere.
Import from Linear
On the Initiatives board, select New initiative > Import from Linear. Paste one or more Linear issue URLs or identifiers, such as ENG-123, then select Fetch and draft. Review the drafted initiative and select Create initiative; the imported issues are linked to it.
Other places
- Create Linear issue checkboxes when you create initiatives from a document or video.
- Create Linear ticket on a feedback form submission.
- Draft tickets with assistant on an initiative's Tracker issues panel opens the assistant to work out several tickets with you, including descriptions, priorities and assignees. Review and approve the drafts before the assistant creates the Linear issues.
Status sync
Reos checks linked issues every 15 minutes and shows them as To do, In progress or Done. When all issues of a phase are done, the phase is marked done, and when every phase is done, the initiative is completed and its owner gets a notification to close the loop with the customers behind the research.
Disconnect Linear
In Settings > Integrations, open Linear, select Disconnect for the workspace, then Disconnect to confirm. Issue creation stops until an admin reconnects it. Issues already created in Linear remain there.
Troubleshooting
- Create issue is grayed out: no tracker is enabled in the organization. Ask an admin or owner to enable one.
- "Linear not enabled for this organization. Enable it in org settings." or "Jira not configured for this organization. Please set a project key in org settings.": your own account is not connected or not enabled here, even if a teammate's is. Connect it in Account settings and have it enabled under Settings > Integrations.
- Status stays the same: wait up to 15 minutes, then reload the initiative.
For help connecting Linear or creating issues, email support@reos.ai.
