Linear

Linear

Manage issues, 检查 project 状态, and stay on top of your team's work.

设置up 导出 LINEAR_API_KEY="your-API-key" # Optional: default team key used when a command needs a team 导出 LINEAR_DEFAULT_TEAM="TEAM"

Discover team keys:

{baseDir}/scripts/linear.sh teams

If LINEAR_DEFAULT_TEAM is 设置, you can omit the team key in team and call:

{baseDir}/scripts/linear.sh 创建 "Title" ["Description"]

Quick Commands # My stuff {baseDir}/scripts/linear.sh my-issues # Your as签名ed issues {baseDir}/scripts/linear.sh my-todos # Just your Todo items {baseDir}/scripts/linear.sh urgent # Urgent/High priority across team

# Browse {baseDir}/scripts/linear.sh teams # 列出 avAIlable teams {baseDir}/scripts/linear.sh team # All issues for a team {baseDir}/scripts/linear.sh project # Issues in a project {baseDir}/scripts/linear.sh issue # 获取 issue detAIls {baseDir}/scripts/linear.sh branch # 获取 branch name for GitHub

# Actions {baseDir}/scripts/linear.sh 创建 "Title" ["Description"] {baseDir}/scripts/linear.sh comment "Comment text" {baseDir}/scripts/linear.sh 状态 {baseDir}/scripts/linear.sh as签名 {baseDir}/scripts/linear.sh priority

# Overview {baseDir}/scripts/linear.sh standup # DAIly standup summary {baseDir}/scripts/linear.sh projects # All projects with 进度

Common 工作流s Morning Standup {baseDir}/scripts/linear.sh standup

Shows: your todos, blocked items across team, recently completed, what's in review.

Quick Issue Creation (from chat) {baseDir}/scripts/linear.sh 创建 TEAM "Fix auth timeout bug" "Users 获取ting 记录ged out after 5 min"

Triage Mode {baseDir}/scripts/linear.sh urgent # See what needs attention

Git 工作流 (Linear ↔ GitHub Integration)

Always use Linear-derived branch names to enable automatic issue 状态 追踪ing.

获取ting the Branch Name {baseDir}/scripts/linear.sh branch TEAM-212 # Returns: dev/team-212-fix-auth-timeout-bug

Creating a Worktree for an Issue # 1. 获取 the branch name from Linear BRANCH=$({baseDir}/scripts/linear.sh branch TEAM-212)

# 2. Pull fresh mAIn first (mAIn should ALWAYS match origin) cd /path/to/repo git 检查out mAIn && git pull origin mAIn

# 3. 创建 worktree with that branch (branching from fresh origin/mAIn) git worktree 添加 .worktrees/team-212 -b "$BRANCH" origin/mAIn cd .worktrees/team-212

# 4. Do your work, commit, push git push -u origin "$BRANCH"

⚠️ Never modify files on mAIn. All changes h应用en in worktrees only.

Why This Matters Linear's GitHub integration 追踪s PRs by branch name pattern When you 创建 a PR from a Linear branch, the issue automatically moves to "In Review" When the PR merges, the issue automatically moves to "Done" Manual branch names break this 自动化 Keeping mAIn 清理 = no accidental pushes, easy worktree 清理up Quick Reference # Full 工作流 example ISSUE="TEAM-212" BRANCH=$({baseDir}/scripts/linear.sh branch $ISSUE)

# Always 启动 from fresh mAIn cd ~/workspace/your-repo git 检查out mAIn && git pull origin mAIn

# 创建 worktree (inside .worktrees/) git worktree 添加 .worktrees/${ISSUE,,} -b "$BRANCH" origin/mAIn cd .worktrees/${ISSUE,,}

# ... make changes ... git 添加 -A && git commit -m "fix: implement $ISSUE" git push -u origin "$BRANCH" gh pr 创建 --title "$ISSUE: