linear-projects-write

Bind's avatarfrom Bind

Create and update Linear projects via CLI (write operations)

⭐4stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026

When & Why to Use This Skill

The linear-projects-write skill enables seamless management of Linear projects directly through a command-line interface. It allows users to programmatically create and update projects, manage team assignments, set priorities, and track project statuses. By bridging the gap between CLI workflows and Linear's project management platform, it significantly enhances productivity for teams looking to automate their project administration tasks.

Use Cases

  • Automated Project Setup: Quickly initialize new Linear projects with specific teams, leads, and descriptions during sprint planning or project kickoffs.
  • Bulk Status Updates: Efficiently update the status, priority, or target dates of multiple Linear projects simultaneously without using the web UI.
  • Workflow Integration: Incorporate Linear project creation and updates into CI/CD pipelines or custom internal automation scripts.
  • Project Lead Assignment: Rapidly assign or change project leads and update project metadata as team structures evolve.
namelinear-projects-write
descriptionCreate and update Linear projects via CLI (write operations)
version1.0.0
licenseMIT
compatibilityopencode

Overview

CLI tools for creating and updating Linear projects. 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 Project

bun .opencode/skill/linear-projects-write/create-project.js --name "..." --teams <teams> [options]

Required:

  • --name <name> - Project name
  • --teams <teams> - Comma-separated team names (e.g., "Engineering,Product")

Options:

  • --description <text> - Project description
  • --lead <name> - Project lead name
  • --status <status> - Initial status (planned, started, paused, completed, canceled)
  • --start-date <date> - Start date (YYYY-MM-DD)
  • --target-date <date> - Target date (YYYY-MM-DD)
  • --priority <0-4> - Priority: 0=none, 1=urgent, 2=high, 3=normal, 4=low
  • --json - Output as JSON

Examples:

bun .opencode/skill/linear-projects-write/create-project.js --name "New Feature" --teams Engineering
bun .opencode/skill/linear-projects-write/create-project.js --name "Q1 Initiative" --teams "Engineering,Product" --lead "James Monroe"
bun .opencode/skill/linear-projects-write/create-project.js --name "Security Audit" --teams Engineering --start-date 2025-01-15 --target-date 2025-03-01

Update Project

bun .opencode/skill/linear-projects-write/update-project.js <project-id-or-name> [options]

Arguments:

  • project-id-or-name - Project UUID or name (partial match supported)

Options:

  • --name <name> - New project name
  • --description <text> - New description
  • --lead <name> - New project lead (use "none" to remove)
  • --status <status> - New status
  • --start-date <date> - New start date (YYYY-MM-DD)
  • --target-date <date> - New target date (YYYY-MM-DD)
  • --priority <0-4> - New priority
  • --json - Output as JSON

Examples:

bun .opencode/skill/linear-projects-write/update-project.js "Mount Vernon" --status completed
bun .opencode/skill/linear-projects-write/update-project.js "Monticello" --lead "John Quincy Adams" --target-date 2025-03-01
bun .opencode/skill/linear-projects-write/update-project.js "Old Project" --name "Hermitage"

Notes

  • Project names support partial matching (case-insensitive)
  • User names are resolved automatically
  • Use --json flag for machine-readable output
  • All commands support --help for detailed usage information