Connecting to Linear

Connect Linear and your Townie can read and manage your issues and projects — find work, file it, update it, and turn conversations into tracked tickets, without leaving Town.

What it can do

Linear is two-way — your Townie can both look things up and change them.

Find issues & projects — “what’s assigned to me?” or “show open bugs in the mobile project.”
Read full details — pull an issue’s description, comments, status, labels, and sub-issues.
Create issues — file a bug or feature with title, description, assignee, priority, labels, and project.
Update issues — change status, reassign, set priority, add labels, link related issues.
Comment — drop an update or note on an issue.
Manage projects — create or update projects, set leads, dates, and status.
Browse your workspace — view teams, projects, workflow states, and team members.
Manage labels — list existing labels and create new ones.

How to connect

Go to /integrations and find Linear, then click Connect.
Authorize Town in Linear (sign in when prompted).
Return to Town — your Townie can now search, create, and update issues and projects.

Town requests read and write access to your Linear workspace. You can revoke access anytime from Linear’s settings.

What your assistant can do

Capability	What it does	Makes changes?
List issues	Find issues with filters	No
Get issue details	View a specific issue	No
Create issue	Create a new issue	Yes
Update issue	Modify an existing issue	Yes
Add comment	Comment on an issue	Yes
List teams	See available teams	No
List projects	View projects	No
Get project details	See project information	No
List workflow states	See issue statuses	No
List users	See team members	No
List labels	See available labels	No
Create label	Add a new label	Yes

What it’s great for

File a bug fast — “create a Linear issue: checkout button crashes on Safari, high priority.”
Turn feedback into tickets — take a user complaint from Slack or email and log it as an issue, including the full thread in the description so your team has the full picture.
Triage your queue — “summarize everything assigned to me that’s still open.”
Run a daily standup — pull issues assigned to you, recently updated issues, and blocked items needing attention.
Keep status current — “mark ENG-412 as done” or “move the launch issues into this sprint.”
Route to the right person — assign issues based on who owns that area.
Link PRs to issues — when a PR is opened, find related issues and track progress across both tools.

Example routine

A routine that creates issues from forwarded emails:


When I forward an email to my assistant with "linear:" in the subject:
1. Extract the issue title from the subject (after "linear:")
2. Use the email body as the issue description
3. Create the issue in my default team
4. Reply with a link to the created issue

Good to know

It works within your Linear access — your Townie sees the teams, projects, and issues your account can.
Be specific when filing — naming the team, project, priority, or assignee helps the issue land correctly the first time.
Use approval-required for creating issues. Creating issues affects your team’s board — review before your Townie creates.
Include context. When creating issues from emails, fold the relevant email context into the description.
Same memory and tools as everywhere else — go straight from an email or Slack thread to a filed, assigned Linear issue in one request.