linear-milestones-write
Create and update Linear project milestones via CLI (write operations)
When & Why to Use This Skill
This Claude skill provides a streamlined CLI-based interface for managing Linear project milestones. It enables users to programmatically create and update project timelines, descriptions, and target dates, facilitating better roadmap tracking and automated project management workflows within the Linear ecosystem.
Use Cases
- Automated Roadmap Initialization: Quickly set up standard project milestones (e.g., Alpha, Beta, GA) for new Linear projects using simple CLI commands or scripts.
- Batch Milestone Updates: Efficiently update target dates and descriptions for existing milestones across multiple projects without navigating the web interface.
- CI/CD Workflow Integration: Automatically create or update release-related milestones in Linear as part of a deployment pipeline or automated release process.
- Terminal-Based Project Tracking: Allow developers and project managers to maintain project schedules and roadmap accuracy directly from their development environment.
| name | linear-milestones-write |
|---|---|
| description | Create and update Linear project milestones via CLI (write operations) |
| version | 1.0.0 |
| license | MIT |
| compatibility | opencode |
Overview
CLI tools for creating and updating Linear project milestones. 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 Milestone
bun .opencode/skill/linear-milestones-write/create-milestone.js --name "..." --project "..." [options]
Required:
--name <name>- Milestone name--project <name>- Project name or UUID
Options:
--description <text>- Milestone description--target-date <date>- Target date (YYYY-MM-DD)--json- Output as JSON
Examples:
bun .opencode/skill/linear-milestones-write/create-milestone.js --name "Alpha Release" --project "Mount Vernon"
bun .opencode/skill/linear-milestones-write/create-milestone.js --name "Beta" --project "Monticello" --target-date 2025-02-01
bun .opencode/skill/linear-milestones-write/create-milestone.js --name "GA" --project "Hermitage" --description "General availability release"
Update Milestone
bun .opencode/skill/linear-milestones-write/update-milestone.js <milestone-id> [options]
Arguments:
milestone-id- Milestone UUID
Options:
--name <name>- New milestone name--description <text>- New description--target-date <date>- New target date (YYYY-MM-DD)--json- Output as JSON
Examples:
bun .opencode/skill/linear-milestones-write/update-milestone.js abc123 --name "Beta Release"
bun .opencode/skill/linear-milestones-write/update-milestone.js abc123 --target-date 2025-03-15
bun .opencode/skill/linear-milestones-write/update-milestone.js abc123 --name "v1.0" --target-date 2025-04-01
Notes
- Project names support partial matching (case-insensitive)
- Milestone IDs are UUIDs (use
list-milestones.jsto find them) - Use
--jsonflag for machine-readable output - All commands support
--helpfor detailed usage information