Help us improve
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
By bahamoth
Linear issue-tracked development workflow for Claude Code. Enforces branch naming, commit conventions, and Linear issue tracking.
npx claudepluginhub bahamoth/claude-linear-workflow --plugin linear-workflowA Claude Code plugin that enforces Linear issue-tracked development workflow with branch naming conventions, Conventional Commits validation, and automatic issue tracking.
# 1. Add marketplace
/plugin marketplace add bahamoth/claude-marketplace
# Or host your own marketplace - see https://code.claude.com/docs/en/plugin-marketplaces
# 2. Install plugin
/plugin install linear-workflow@bahamoth/claude-marketplace
# 3. Enable plugin
/plugin enable linear-workflow
# 4. Authenticate Linear MCP (opens browser for OAuth)
/mcp linear-mcp auth
Add your Linear team to .claude/settings.json:
{
"env": {
"LINEAR_WORKFLOW_TEAM": "YourTeam",
"LINEAR_WORKFLOW_PROJECT": "YourProject"
}
}
| Variable | Required | Description |
|---|---|---|
LINEAR_WORKFLOW_TEAM | Yes | Your Linear team name |
LINEAR_WORKFLOW_PROJECT | No | Project for new issues (Backlog if omitted) |
If LINEAR_WORKFLOW_TEAM is not configured, the plugin will block implementation and guide you to set it up.
Has Issue No Issue
│ │
▼ ▼
Query via MCP Plan → Create Issue in Linear
│ │
└──────────┬─────────────────┘
▼
Create branch (use gitBranchName)
▼
Linear status: In Progress + start comment
▼
Work (comment on decisions/blockers)
▼
Create PR (Fixes {PREFIX}-XX)
▼
Merge (rebase-ff) → Linear auto-Done
When you try to exit plan mode on main, the plugin blocks and guides you to:
gitBranchNameUse the gitBranchName field from the Linear issue:
git checkout -b <gitBranchName>
Branch format is configured in Linear: Settings > Workspace > Integrations > Branch format
Follow Conventional Commits format:
type(scope): description
Refs ABC-123
Format: type(scope): description where type is any lowercase word (commonly feat, fix, docs, refactor, etc.)
Include Linear magic words to auto-close issues:
Fixes ABC-123
| Hook | Event | Matcher | Purpose |
|---|---|---|---|
check_linear_env.py | UserPromptSubmit | - | Early warning if env not configured |
check_linear_env.py | PreToolUse | Write|Edit|ExitPlanMode | Re-check env before implementation |
ensure_linear_branch.py | PreToolUse | Write|Edit|ExitPlanMode | Enforce Linear branch before changes |
validate_commit_msg.py | PreToolUse | Bash | Validate Conventional Commits |
| Prompt | PreCompact | - | Sync progress to Linear comments |
MIT
Executes bash commands
Hook triggers when Bash tool is used
Modifies files
Hook triggers on file write and edit operations
Share bugs, ideas, or general feedback.
Based on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Linear ticket and project workflows with wrapper scripts for issues, milestones, documents, and PR coordination
Work on issues from GitHub, Linear, or GitLab
A workflow automation system that helps Claude Code implement features systematically with built-in planning, validation, and review steps
Manage Linear issues from the command line
Git 워크플로우, 브랜치 전략, 커밋 컨벤션, TiDD(Ticket Driven Development) 가이드
Linear issue tracking integration and workflow management
NC(NCSOFT) CI 가이드라인 기반 PPTX 테마 및 슬라이드 레이아웃 — 색상, 서체, 8종 레이아웃, react-icons 아이콘 가이드
Modern development conventions and toolchain enforcement — Python, Rust, TypeScript and more
External network access
External network access
Connects to servers outside your machine
Connects to servers outside your machine
Share bugs, ideas, or general feedback.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claim