Connect Linear
Connect a Linear workspace so missions can start from an issue and report back on it.
Overview
Linear is one place where a project's work can be planned. When you connect it, SHIP becomes an agent that your team can mention on an issue. The mission starts from the issue and reports its progress there. The people who file the work do not install anything.
Linear is optional. A project can use GitHub Issues instead. It can also use no tracker at all and take its work from the terminal. See Ways of working.
Steps
Authorize the workspace
On the Connect step of onboarding, click Connect Linear. Then complete Linear's OAuth flow. The grant makes SHIP an agent in your workspace that you can assign and mention. It also lets SHIP read issues, post updates and run agent sessions.
Pick the team
On the Project step, choose Linear as the place where this project's work is planned. Then select the team. A project is limited to one team, and you can hand the issues in that team to the agent.
Starting a mission
Mention @SHIP on an issue, or assign the issue to the agent.
The mission replies in Linear's agent session, where other agents also respond. It posts its plan, the review verdict and the QA verdict there at each stage. The pull request that it opens links back to the issue.
An issue that is good enough for a person is usually good enough for an agent. It says what you want and how you will know that it is done. QA verifies against the acceptance criteria that you write as checkboxes, so make those criteria specific.
Steering a running mission
Reply on the issue. The agents take the instruction and continue on the mission's open pull request. If you ask for a change to the output of one stage, SHIP runs that stage again and does not restart the mission.
@SHIP pause, @SHIP resume and @SHIP stop control the mission. The console detail page has the same three controls as buttons. If a mission escalates for attention, restart it from that page.
Troubleshooting
The agent doesn't respond to a mention
At linear.app/settings/integrations, check that the app is still authorized. Also, the mention must come from Linear's own composer. A comment that a program posts through Linear's API does not trigger the event that starts a mission. For automation, use the API or the CLI, not a comment.
The agent responds but cannot find the issue
Make sure that the issue is in the team you selected for the project. A project is limited to one team.
Labels named in configuration never appear
SHIP attaches labels that already exist in your workspace and skips labels that do not. It never creates labels, statuses or teams, because SHIP does not change the schema of your workspace.
How is this page?