feat: add cycle list/view commands and issue list --cycle filter#162
Merged
schpet merged 2 commits intoschpet:mainfrom Mar 4, 2026
Merged
feat: add cycle list/view commands and issue list --cycle filter#162schpet merged 2 commits intoschpet:mainfrom
schpet merged 2 commits intoschpet:mainfrom
Conversation
This was referenced Mar 4, 2026
Owner
|
@regaw-leinad wonderful thank you! i'll take a look at this sometime soon. in the interim, can you let me know if you've tried this out / confirmed it works for you? squinting at it, it looks right, but i always like to ensure some human verification was done. |
Contributor
Author
|
@schpet yeah! tested all three commands against my startup's Linear workspace and everything worked. here's what it looks like (changed the actual data but the structure is the same): also ran the full test suite, 213 passing. |
Owner
|
@regaw-leinad cool! well that's awesome, this has been a gap for a while so i appreciate this. if you notice anything to do with cycles, don't hesitate to make a pr or file an issue – i don't use them so i'm unlikely to notice anything isn't working right. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
linear cycle listandlinear cycle viewcommands for browsing team cycles--cyclefilter tolinear issue listfor filtering issues by cycleProblem
PR #150 added cycle support to issue create/update/view, but there was no way to browse cycles themselves or filter issue lists by cycle. Users had to know cycle names/numbers without being able to look them up from the CLI. See #64.
Fix
Adds a
cyclecommand group (aliasedcy) with two subcommands, following the same patterns as the existingmilestonecommands:cycle listshows all cycles for a team with number, name, dates, and status. Active cycle is highlighted in green, upcoming cycles use default color, and completed/past cycles are muted.cycle viewshows full cycle details including a progress indicator, description, issue breakdown by state, and first 10 issues. Accepts cycle name, number, or "active".issue list --cyclefilters the issue list to a specific cycle, reusing the existinggetCycleIdByNameOrNumber()utility and the GraphQLIssueFilter.cyclefield.Why
Cycles are a core part of the Linear workflow and the CLI should support browsing them.
cycle listlets you see what's available,cycle viewgives you sprint progress at a glance, and--cycleon issue list lets you scope your view to a specific sprint.Test Plan
cycle viewtested with active, by number, and by exact name lookup