Connect Linear

Sheru browses your Linear teams, issues, and comments as a read-only file tree. Connecting takes one personal API key you generate in Linear and paste into Sheru — Sheru stores it locally on your Mac and never sends it anywhere but Linear.

1. Create a personal API key#

1. Open linear.app/settings/api (Linear ▸ Settings ▸ API).
2. Under Personal API keys, click Create key, give it a label (e.g. Sheru), and create it.
3. Copy the key — Linear shows it once.

2. Paste it into Sheru#

1. Open Settings (⌘,) ▸ Connectors ▸ Add Connector ▸ Linear.
2. Paste the key into the field and click Connect.

Sheru checks the key, then a Linear source appears in the sidebar. The key is stored locally in ~/.sheru/config.json (readable only by you); it never leaves your machine except in requests to Linear.

What you get#

• The top level lists one folder per team, by team key (e.g. ENG/).
• Inside a team: the workflow-state buckets Backlog/, Todo/, In Progress/, Done/, Cancelled/, Triage/.
• Inside a bucket: one folder per issue, named by its identifier (e.g. ENG-123/).
• Inside an issue: an issue.md with the full description and a comments/ folder, one markdown file per comment.

Sheru only ever reads Linear — the connection can't modify your issues from the file tree.

Notes#

• To disconnect, use Remove next to Linear in Settings — that drops the source and forgets the key.
• A personal API key carries your own access; revoke it any time from the same Linear settings page.