Claude Linear Sync — Git skill for Claude Code

claude-linear-sync

Automated Linear ticket tracking for Claude Code. Tickets get created when you start tasks and closed with changelogs when you commit — no manual updating required.

Before & After

**Before**: Work happens in Claude Code, Linear gets updated retroactively in bulk.

**After**: Claude creates tickets when tasks start, updates them with commit details, and closes them when done. PR bodies automatically get Linear links.

How It Works

User prompt  →  [classify_prompt.py]  →  detects task  →  injects context
                                                               ↓
                                         Claude creates Linear ticket via MCP
                                         Claude writes state file
                                                               ↓
                                         Work happens (edits, tests, etc.)
                                                               ↓
git commit   →  [detect_commit.sh]    →  reads state   →  injects context
                                                               ↓
                                         Claude updates ticket + marks Done via MCP
                                                               ↓
PR created   →  [GitHub Action]       →  scans commits  →  adds Linear links to PR body

**Two Claude Code hooks** + **behavioral instructions in CLAUDE.md** + an optional **GitHub Action**.

Prerequisites

• Claude Code (CLI)
• Linear MCP server connected to Claude Code
• A Linear workspace with a team and project

Connecting the Linear MCP Server

claude mcp add linear-server npx @ibraheem4/linear-mcp
# Then set LINER_API_KEY in your environment

Quick Start

git clone https://github.com/YOUR_ORG/claude-linear-sync.git
cd claude-linear-sync
python3 setup.py

The setup wizard will:

1. Ask for your Linear workspace s