linear-projects-write
Create and update Linear projects via CLI (write operations)
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.
| name | linear-projects-write |
|---|---|
| description | Create and update Linear projects via CLI (write operations) |
| version | 1.0.0 |
| license | MIT |
| compatibility | opencode |
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_KEYset in<git-root>/.envor 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
--jsonflag for machine-readable output - All commands support
--helpfor detailed usage information