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
bash
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:
bash
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
bash
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:
bash
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