linear-issues-write

Overview

CLI tools for creating and updating Linear issues. Requires LINEAR_API_KEY set in <git-root>/.env or exported in the environment.

Prerequisites

• bun runtime installed
• LINEAR_API_KEY set in <git-root>/.env or environment

Commands

Create Issue

bun .opencode/skill/linear-issues-write/create-issue.js --title "..." --team <team> [options]

Required:

• --title <title> - Issue title
• --team <name> - Team name (e.g., Engineering)

Options:

• --description <text> - Issue description
• --assignee <name> - Assignee name
• --priority <0-4> - Priority: 0=none, 1=urgent, 2=high, 3=medium, 4=low
• --labels <labels> - Comma-separated labels (e.g., "Bug,SOC2")
• --project <name> - Project name
• --json - Output as JSON

Examples:

bun .opencode/skill/linear-issues-write/create-issue.js --title "Fix login bug" --team Engineering --priority 2
bun .opencode/skill/linear-issues-write/create-issue.js --title "New feature" --team Engineering --labels "Feature" --assignee "John Adams"
bun .opencode/skill/linear-issues-write/create-issue.js --title "Security fix" --team Engineering --project "Monticello" --priority 1

---

Update Issue

bun .opencode/skill/linear-issues-write/update-issue.js <issue-id> [options]

Arguments:

• issue-id - Issue identifier (e.g., ENG-123) or UUID

Options:

• --title <title> - New title
• --description <text> - New description
• --status <status> - New status (e.g., "In Progress", "Done")
• --assignee <name> - New assignee (use "none" to unassign)
• --priority <0-4> - New priority
• --labels <labels> - Replace all labels
• --add-labels <labels> - Add labels without removing existing
• --project <name> - Set project (use "none" to remove)
• --json - Output as JSON

Examples:

bun .opencode/skill/linear-issues-write/update-issue.js ENG-123 --status "In Progress"
bun .opencode/skill/linear-issues-write/update-issue.js ENG-123 --assignee "Thomas Jefferson" --priority 2
bun .opencode/skill/linear-issues-write/update-issue.js ENG-123 --add-labels "Bug,Urgent"
bun .opencode/skill/linear-issues-write/update-issue.js ENG-123 --assignee none

---

Notes

• Team, user, and label names are resolved automatically (case-insensitive)
• Use --json flag for machine-readable output suitable for scripting
• All commands support --help for detailed usage information