Linear Status - Check Workflow Status

Display comprehensive status of the current Linear workflow including issue, branch, PR, and CI status.

Usage: /yux-linear-status

Workflow

Step 0: Load Configuration and Sync Local State

This step loads config and ensures local state is synchronized with Linear.

1. Read .claude/linear-config.json if exists

2. Use team/project info for display header (e.g., "Wyx Team - subloom-api Project")

3. If no config exists, show warning but continue with git-only info:

   Note: Linear configuration not found. Run `/yux-linear-start` to set up team/project for full workflow.
   

4. Get current branch and extract Linear issue ID:

   git branch --show-current
   

   Extract pattern: LIN-\d+

5. Check for local state file:

   • Path: .claude/linear-tasks/<ISSUE_ID>.json
   • If exists, load and verify

6. If local state is missing or outdated:

   • Fetch issue from Linear:

     mcp__linear__get_issue(id: "<issue-uuid-or-identifier>")
     

   • Rebuild local state file:

     mkdir -p .claude/linear-tasks
     

     Write to .claude/linear-tasks/<ISSUE_ID>.json:

     {
       "issue_id": "LIN-456",
       "issue_uuid": "<uuid-from-linear>",
       "issue_title": "<title-from-linear>",
       "branch_name": "<current-branch>",
       "status": "<current-status>",
       "linear_url": "<url-from-linear>",
       "synced_at": "<current-timestamp>",
       "verified": true
     }
     

   • Output sync status:

     ✓ Local state synchronized from Linear
     

7. If Linear issue not found:

   • Output warning:

     ⚠️ Issue not found in Linear. The issue may have been deleted.
     

Step 1: Gather Git Information

1. Get current branch:

   git branch --show-current
   

2. Extract Linear issue ID from branch name:

   • Pattern: LIN-\d+
   • If not found, check for any open issue context

3. Get commit count:

   git rev-list --count origin/main..HEAD
   

4. Get uncommitted changes:

   git status --porcelain | wc -l
   

Step 2: Fetch Linear Issue Details

If issue ID found:

mcp__linear__get_issue(id: "LIN-xxx")

Extract:

• Title
• Status (Backlog, Todo, In Progress, In Review, Done)
• Priority
• Assignee
• Labels
• Created date
• Recent comments

Step 3: Check PR Status

1. Find associated PR:

   gh pr list --head <current-branch> --json number,title,state,url
   

2. If PR exists, get details:

   gh pr view <number> --json state,reviews,mergeable,mergeStateStatus
   

Step 4: Check CI/CD Status

If PR exists:

gh pr checks <pr-number> --json name,state,conclusion,startedAt,completedAt

Parse results:

• queued → ○ (pending)
• in_progress → ○ (running)
• completed + success → ✓ (passed)
• completed + failure → ✗ (failed)
• completed + skipped → ⊘ (skipped)

Step 5: Generate Status Report

Full status display:

╔══════════════════════════════════════════════════════════════╗
║       Linear Workflow Status (Wyx - subloom-api)             ║
╠══════════════════════════════════════════════════════════════╣
║                                                               ║
║  Issue                                                        ║
║  ──────────────────────────────────────────────────────────  ║
║  ID:       LIN-456                                            ║
║  Title:    Implement user authentication                      ║
║  Status:   In Review                                          ║
║  Priority: High                                               ║
║  Created:  2024-01-15 10:30                                   ║
║                                                               ║
║  Branch                                                       ║
║  ──────────────────────────────────────────────────────────  ║
║  Name:     feat/LIN-456-user-auth                            ║
║  Commits:  5 ahead of main                                    ║
║  Changes:  2 uncommitted files                                ║
║                                                               ║
║  Pull Request                                                 ║
║  ──────────────────────────────────────────────────────────  ║
║  PR:       #78 - [LIN-456] Implement user authentication     ║
║  URL:      https://github.com/org/repo/pull/78               ║
║  Status:   Open                                               ║
║  Reviews:  0/2 approved                                       ║
║  Merge:    Ready (no conflicts)                               ║
║                                                               ║
║  CI/CD                                                        ║
║  ──────────────────────────────────────────────────────────  ║
║  ├── ✓ lint          (12s)                                   ║
║  ├── ✓ build         (45s)                                   ║
║  ├── ✓ test          (2m 30s)                                ║
║  ├── ✓ e2e           (5m 12s)                                ║
║  └── ✓ deploy-preview (1m 8s)                                ║
║                                                               ║
║  Status: All 5 checks passed                                  ║
║                                                               ║
║  Timeline                                                     ║
║  ──────────────────────────────────────────────────────────  ║
║  10:30  Issue created                                         ║
║  10:32  Branch created                                        ║
║  12:45  PR created                                            ║
║  12:50  CI started                                            ║
║  12:58  CI passed                                             ║
║                                                               ║
╚══════════════════════════════════════════════════════════════╝

---
📋 Next Steps:

\`\`\`
/yux-linear-merge
\`\`\`
Ready to merge! All CI checks passed.

Status Output with Local State Info

Include local state file information in the output:

=== Linear Workflow Status ===

Issue:   LIN-456 - User authentication
Status:  In Progress
Branch:  feat/LIN-456-user-auth
URL:     https://linear.app/team/issue/LIN-456

Local State
──────────────────────────────────────
File:    .claude/linear-tasks/LIN-456.json ✓
Synced:  2026-01-09 10:30:00

Next Steps
──────────────────────────────────────
→ Make some changes and commit

Simplified Output (when not on task branch)

=== Linear Workflow Status ===

Current branch: main

No active Linear task detected.

---
📋 Next Steps:

\`\`\`
/yux-linear-start
\`\`\`
Begin a new task

Status Indicators

Symbol	Meaning
✓	Passed/Complete
✗	Failed
○	Running/Pending
⊘	Skipped
→	Next action

Next Steps Suggestions

Based on current state, display appropriate next step with copyable command:

State	Next Step Output
No branch	📋 Next Steps:<br>/yux-linear-start<br>"Begin a new task"
No commits	"Make some changes and commit"
No PR	📋 Next Steps:<br>/yux-linear-pr<br>"Create a Pull Request"
CI running	📋 Next Steps:<br>/yux-linear-status<br>"Refresh to check CI progress"
CI failed	"Fix the failing checks, then git push"
CI passed	📋 Next Steps:<br>/yux-linear-merge<br>"Merge the PR to complete"
Needs review	"Waiting for code review approval"

Output format for next steps (always use code blocks for commands):

---
📋 Next Steps:

\`\`\`
/yux-linear-merge
\`\`\`
Merge the PR to complete the task

Error Handling

• Not in git repo: "Please navigate to a git repository"
• Linear not configured: "Linear MCP not available. Run /mcp to configure"
• No issue found: Show available info (branch, commits) without Linear details

Multi-language Support

Detect user language and display messages accordingly:

Chinese:

=== Linear 工作流状态 ===

Issue:    LIN-456 - 实现用户认证
状态:     审核中
分支:     feat/LIN-456-user-auth

---
📋 下一步 / Next Steps:

\`\`\`
/yux-linear-merge
\`\`\`
准备合并！所有 CI 检查已通过