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.

Read .claude/linear-config.json if exists
Use team/project info for display header (e.g., "Wyx Team - subloom-api Project")

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.

Get current branch and extract Linear issue ID:
```
git branch --show-current
```
Extract pattern: LIN-\d+
Check for local state file:
- Path: .claude/linear-tasks/<ISSUE_ID>.json
- If exists, load and verify

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

If Linear issue not found:

Output warning:

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

Step 1: Gather Git Information

Get current branch:
```
git branch --show-current
```
Extract Linear issue ID from branch name:
- Pattern: LIN-\d+
- If not found, check for any open issue context
Get commit count:
```
git rev-list --count origin/main..HEAD
```
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

Find associated PR:

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

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

All output messages follow .claude/yux-config.json setting

Status display and all messages are output in the configured language.