## Summary
Adds comprehensive milestone management functionality to linear-cli,
enabling full CRUD operations for Linear project milestones.
## Motivation
The Linear API supports project milestones, but the CLI didn't expose
this functionality. This PR adds milestone management commands to
complement the existing project and issue commands.
## Changes
### New Commands
- `linear milestone list --project <id>` - List milestones for a project
- `linear milestone create` - Create new project milestones
- `linear milestone update <id>` - Update existing milestones
- `linear milestone delete <id>` - Delete milestones with confirmation
- Short alias: `linear m` for all milestone commands
### Features
- Full CRUD operations for project milestones
- Table-formatted output for list command
- Interactive confirmation prompts for deletion (with `--force` option
to skip)
- Support for milestone name, description, and target date
- Follows existing CLI patterns and conventions
### Implementation
- Uses GraphQL Code Generator for type-safe queries/mutations
- Built with Cliffy for command structure and prompts
- Leverages existing graphql client utilities
- Includes spinner for loading states
- Updated README with usage examples
## Testing
All commands have been tested with the Linear API:
- ✅ List milestones for a project (empty and populated)
- ✅ Create milestones with name, description, target date
- ✅ Update milestone properties
- ✅ Delete milestones with confirmation prompt
- ✅ Delete with `--force` flag (skip confirmation)
## Documentation
Updated README.md with:
- Milestone commands section
- Usage examples for all operations
- Command aliases
## Example Usage
```bash
# List milestones
linear milestone list --project abc123
linear m list --project abc123 # alias
# Create a milestone
linear milestone create --project abc123 --name "Q1 Goals" --target-date "2026-03-31"
linear m create --project abc123 # interactive mode
# Update a milestone
linear milestone update xyz789 --name "Q1 Objectives"
linear m update xyz789 --target-date "2026-04-15"
# Delete a milestone
linear milestone delete xyz789
linear m delete xyz789 --force # skip confirmation
```
The README documented that environment variables take precedence over
config file values, but the code had the opposite behavior. This fix
corrects the precedence order in getRawOption to match the documentation:
1. CLI flags (highest priority)
2. Environment variables
3. Config file (lowest priority)
Also adds subprocess-based tests that verify:
- Env vars win when both env var and config file are present
- Config file is used as fallback when no env var is set
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add the issue identifier (e.g., TEST-123) before the title in the
issue view command output. The title now displays as "TEST-123: Fix
authentication bug" instead of just "Fix authentication bug".
- Add identifier field to fetchIssueDetails return type
- Include identifier in both GraphQL queries
- Update issue-view.ts to prefix title with identifier
- Update all test mocks to include identifier field
Claude-session-id: a1d9f23b-b88b-4571-b44a-37003734e4a1
## Summary
- Add parent issue display to `linear issue view` output (when the issue
has a parent)
- Add sub-issues list to `linear issue view` output (when the issue has
children)
- Enables agents and users to easily navigate up and down the issue
hierarchy
Closes#84
## Example Output
```
# Implement user authentication
Add user authentication to the application.
Parent:
TEST-100: Epic: Security Improvements [In Progress]
Sub-issues:
TEST-457: Add login form [Done]
TEST-458: Add password reset flow [Todo]
TEST-459: Add OAuth support [In Progress]
```
## Test plan
- [x] Added new test case "With Parent And Sub-issues" to verify
hierarchy display
- [x] Updated existing tests to include parent/children fields in mock
data
- [x] All snapshot tests updated and passing
- [x] `deno check` passes
- [x] `deno lint` passes
🤖 Generated with [Claude Code](https://claude.com/claude-code)
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
use case:
- you are addressing feedback on an issue ABC-123
- run `linear issue start 123` to re-start that issue
- fire up claude code
- run `! linear issue view` to drop the issue, and comments into context
- run `! linear issue commits` to dump the diff of previous work into
context
- ask claude to address the feedback (it will have a much better shot of
knowing what you are talking about)
Replace the get-graphql-schema npm package with the built-in
'linear schema' command, using the -o flag to write output to file
instead of stdout redirection.
Claude-session-id: c951003d-76bb-446c-9c38-d448f2f768af
Create Claude Code skill plugin for linear-cli with marketplace and
plugin metadata. Includes SKILL.md documentation that explains how to
use the linear-cli CLI tool for managing Linear issues from the
command line.
- Add marketplace.json with plugin configuration
- Add plugin.json with plugin metadata
- Add skills/linear-cli/SKILL.md with usage documentation
Claude-session-id: 60a47cf8-9f8d-46a9-bbde-6097eafd8584
Implement a new top-level command that fetches the GraphQL schema from
Linear's API via introspection and prints it to stdout. Supports SDL
format by default and JSON output with --json flag.
Claude-session-id: 84fcd993-f47a-44d2-b173-69f9415ed989
Document all supported configuration options in the README with a
table showing environment variable names, TOML config keys, example
values, and descriptions. Include information about valid config file
locations and precedence rules.
Claude-session-id: 0effccb0-b575-4bf8-b1c7-5b850894d475
Extend hyperlink support to work consistently for both issue descriptions
and comments by using charmd markdown rendering with OSC-8 extensions.
- Use renderMarkdown with extensions for comment body rendering
- Remove formatWrappedText function, replaced by markdown rendering
- Pass extensions array through captureCommentsForTerminal function
- Apply proper indentation to rendered reply comments
Claude-session-id: 49101792-03cc-423f-8162-4e8fd125d1b4
Implement local image caching for issue view command to avoid
exposing authenticated Linear URLs. Images are downloaded to a
temporary directory and cached for reuse.
- Add image download and caching system
- Update deno.json permissions for temporary directories and
uploads.linear.app domain access
- Add dependencies: remark, unified, mdast, valibot, sanitize-filename
- Add LINEAR_DOWNLOAD_IMAGES env var and download_images config option
(enabled by default, disable with --no-download flag)
Claude-session-id: 626af003-386f-486b-8357-db352b0b5766
When sorting issues by priority, apply manual sort order (drag
position) as a tertiary sort after priority, matching the behavior
of the Linear app. This ensures issues within each priority group
maintain their manual ordering.
Claude-session-id: f15ec08b-4174-460c-a3bd-b00629eb708e
Fix flaky test that was failing due to non-deterministic port numbers
in error messages and Docker listening on the hardcoded test port.
- Change test endpoint from port 3000 to 59123 to avoid Docker
conflicts that caused timeouts
- Normalize ephemeral port numbers in error messages to a stable
placeholder (127.0.0.1:PORT)
Claude-session-id: a1a55e89-c333-41b3-8034-b9cbe6514ad3
Pass CARGO_DIST_TARGET to deno compile to ensure correct architecture
binaries are produced for each target. Without --target, deno defaults to
the host architecture, causing aarch64 release assets to contain x86_64
binaries when built on x86_64 GitHub runners.
Claude-session-id: c7276b7f-5177-42e7-86c0-dcda770612bf
Add documentation for the new comment management commands:
- linear issue comment list: view all comments on an issue
- linear issue comment add: add a new comment or reply
- linear issue comment update: modify an existing comment
Claude-session-id: d5069805-c5b7-479c-bc65-f7d20f7c39d7
Update prepareJjWorkingState, setJjDescription, and
createJjNewChange to capture stdout and stderr instead of
inheriting them. Only print errors to the console if the
command fails.
Claude-session-id: ae02c694-fdfb-4a59-b56a-72b3761afb1a
Skip looking up the issue ID from the current git branch or jj
description when no ID is provided. This ensures the command always
prompts the user to select from a list of unstarted issues rather
than automatically continuing work on the current issue.
Claude-session-id: bef23d17-e070-4dc2-a228-23d536c40cb9
When starting work on an issue with jj, the workflow now creates a
new empty change after setting the description. This allows the issue
metadata to be in a parent commit while having a fresh change to work
on, matching typical development workflows.
- Add createJjNewChange function to jj.ts
- Call createJjNewChange after setJjDescription in startVcsWork
- Import new function in vcs.ts
Claude-session-id: d386df16-73ae-46eb-b7d6-bcc3d6d74df3
- Add option to customize branch name
- Allows overriding the auto-generated branch name based on issue identifier
- Follows project naming conventions (consistent with --base/--head in pull-request)
- Maintains backward compatibility - existing behavior unchanged when option not provided
- Add GetIssuesForStateQuery type import
- Add explicit type annotation for result variable in pagination loop
- Update snapshot tests to reflect new --limit option in help text
- Fixes TypeScript type checking error (TS7022)
Peter Schilling