linear-sync
Installation
SKILL.md
Contains Shell Commands
This skill contains shell command directives (!`command`) that may execute system commands. Review carefully before installing.
Linear Sync Workflow
This system keeps Linear and GitHub in sync automatically. Linear API queries go through the linear-sync subagent (foreground), while simple mutations use linear-api.sh directly via Bash.
Session Start Behavior
At the start of every session, the linear-session-start hook fires and checks the repo:
- Linked repo: The hook injects config context (workspace, project, team, label, formats, last_issue if any, stale branch warnings, and pre-fetched digest if due). Follow the session kickoff directive below.
- Opted-out repo (
workspace: "none"): The hook is silent. Do nothing related to Linear. - Unregistered repo: The hook injects a
[LINEAR-SETUP]directive. Follow the setup wizard rules below. If a.linear-sync-template.jsonis found, the hook also injects[LINEAR-TEMPLATE]with defaults to pre-fill. - Broken workspace reference: The hook injects a
[LINEAR-SETUP]directive to reconfigure or opt out.
Session Kickoff (Linked Repos)
When the hook injects config context for a linked repo:
Step 1: Digest and stale branches