# Linear Milestones Read

> List Linear project milestones via CLI (read-only operations)

- Skill: `aiskillstore/linear-milestones-read` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add aiskillstore/linear-milestones-read`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aiskillstore/linear-milestones-read/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: aiskillstore (https://skillmd.com/u/aiskillstore)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/aiskillstore/linear-milestones-read

---


## Overview

CLI tools for reading Linear project milestones. Requires `LINEAR_API_KEY` set in `<git-root>/.env` or exported in the environment.

## Prerequisites

- [bun](https://bun.sh) runtime installed
- `LINEAR_API_KEY` set in `<git-root>/.env` or environment

## Commands

### List Milestones

```bash
bun .opencode/skill/linear-milestones-read/list-milestones.js [options]
```

**Options:**
- `--project <name>` - Filter by project name (required unless using --all)
- `--all` - List milestones across all projects
- `--limit <n>` - Max results (default: 25)
- `--json` - Output as JSON

**Examples:**
```bash
bun .opencode/skill/linear-milestones-read/list-milestones.js --project "Mount Vernon"
bun .opencode/skill/linear-milestones-read/list-milestones.js --all --limit 10
bun .opencode/skill/linear-milestones-read/list-milestones.js --project "Monticello" --json
```

---

## Output Behavior

- Command output is displayed directly to the user in the terminal
- **Do not re-summarize or reformat table output** - the user can already see it
- Only provide additional commentary if the user explicitly requests analysis, filtering, or summarization
- When using `--json` output with tools like `jq`, the processed results are already visible to the user

## Notes

- Project names support partial matching (case-insensitive)