Skip to content

linear

Work fasterv0.1.0

Your Linear issues in a sidebar, with one click to start work.

claude: linear
What you are seeing A sidebar lists assigned Linear issues as cards grouped by status, each with a Start button, beside the Claude conversation.

Install

o-mods
  1. Add the o-mods collection (once):

    claude plugin marketplace add omeerdvrn/o-mods

  2. Install this mod:

    claude plugin install linear@o-mods

Then run /reload-plugins in any open Claude Code session.

First time? Set up o-mods

Author
omeerdvrn
Version
0.1.0
License
MIT
Tags
linear, issues, worktree, sidebar
Source on GitHub
Source on GitHub

A Claude Code mod that shows the Linear issues assigned to you in a sidebar. Press Start on an issue to create a git worktree for it and have Claude implement it there.

My issues                               15:47 ⟳

All 51   Todo 25   In progress 9   In review 4   Done 44

◐ In Progress 9
╭────────────────────────────────────────────────╮
│ ▮▮▮ ENG-1930                             3 pts │
│ Login page ignores the remember-me checkb…     │
│ ◐ In Progress  Acme                    ▶ Start │
╰────────────────────────────────────────────────╯

Features ​

  • Cards for your assigned issues, grouped by Linear status and colored like Linear: priority, ID, estimate, title, status, project.
  • Filters: All open issues, Todo, In progress, In review, and Done (finished in the last 30 days).
  • Click a card's title to see the full issue: status, priority, estimate, project, team, due date, labels, branch, and the description.
  • Start creates a worktree at <repo>/.claude/worktrees/<issue-id> on the branch name Linear suggests, moves the issue to In Progress, and starts the implementation.
  • Syncs on start and every 5 minutes. /linear refresh syncs on demand.

Requirements ​

  • Claude Code with function-hook mods (2.1.29x or later). The mod API is in early access, so check the mod after major Claude Code updates.
  • Linear connected to Claude: the claude.ai Linear connector, or your own Linear MCP server. Run /mcp to check.
  • For the docked sidebar: "tui": "fullscreen" in ~/.claude/settings.json and a terminal at least 144 columns wide. On narrower terminals, type /linear to open it.

Use ​

ActionHow
Open the sidebarIt opens by itself on wide terminals, or type /linear
Sync nowPress ⟳, or type /linear refresh
FilterPress All, Todo, In progress, In review, or Done
See an issue in fullClick its title. Press ✕ to close it.
Start workPress ▶ Start on the card

Settings ​

Change these in /config under linear.

SettingDefaultWhat it does
repoPathsession folderThe git repository to create worktrees in.
baseRefHEADThe branch or commit that new issue branches start from.
startModesessionsession: this session switches into the worktree and implements the issue. agent: a background agent implements it in the worktree.
moveToInProgresstrueSets the issue to In Progress in Linear when you press Start.
linearServerclaude.ai LinearThe name of your Linear MCP server, as /mcp lists it.
statusColorsemptyColors for custom statuses, as Name=#HEX pairs: Blocked=#EB5757, Test=#26B5CE.

Linear's MCP server does not return status colors. The mod uses Linear's default colors for the standard statuses (Triage, Backlog, Todo, In Progress, In Review, Done, Canceled). Set statusColors for any custom statuses.

Add .claude/worktrees/ to the .gitignore of the repositories you use this with.

Development ​

Run the mod from a local clone:

claude --plugin-dir /path/to/o-mods/mods/linear

The session reloads the mod when you save a file. To check your changes, run these from this folder:

claude plugin validate .
claude plugin test .
FileContents
hooks/register.tsxHooks: sync, the /linear command, Start, and the sidebar UI
hooks/linear.tsLinear data parsing, worktree paths, and the implementation brief
hooks/look.tsStatus colors and icons, priority icons, estimates, and due dates
types/index.d.tsThe mod's state contract
tests/sidebar.test.tsTests that run with Linear and git faked

To release an update, increase version in .claude-plugin/plugin.json and push. Users then run claude plugin update linear and /reload-plugins.

Edit this page on GitHub