linear-milestones-write

Bind's avatarfrom Bind

Create and update Linear project milestones via CLI (write operations)

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

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.
namelinear-milestones-write
descriptionCreate and update Linear project milestones via CLI (write operations)
version1.0.0
licenseMIT
compatibilityopencode

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_KEY set in <git-root>/.env or 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.js to find them)
  • Use --json flag for machine-readable output
  • All commands support --help for detailed usage information