Skip to content

feat: split issue list into mine and query commands #205

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
schpetbot merged 1 commit into from
Apr 3, 2026
Merged

feat: split issue list into mine and query commands #205

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,9 @@ here's how it works:
```bash
linear config # setup your repo, it writes a config file

linear issue list # list unstarted issues assigned to you
linear issue list -A # list unstarted issues assigned to anyone
linear issue search "login bug" # search issues in your configured team
linear issue mine # list unstarted issues assigned to you
linear issue query --all-teams # query issues across all teams
linear issue query --search "login bug" # search issues in your configured team
linear issue start # choose an issue to start, creates a branch
linear issue start ABC-123 # start a specific issue
linear issue view # see current branch's issue as markdown
Expand Down Expand Up @@ -135,8 +135,9 @@ linear issue list # list your issues in a table view (supports -s/--state a
linear issue list --project "My Project" --milestone "Phase 1" # filter by milestone
linear issue list -w # open issue list in web browser
linear issue list -a # open issue list in Linear.app
linear issue search "login bug" # search issues by text in your configured team
linear issue search "oauth timeout" --team ENG --json # structured search output for agents
linear issue query --search "login bug" # search issues by text in your configured team
linear issue query --search "oauth timeout" --team ENG --json # structured search output for agents
linear issue query --all-teams --json --limit 0 # export all issues as JSON
linear issue start # create/switch to issue branch and mark as started
linear issue create # create a new issue (interactive prompts)
linear issue create -t "title" -d "description" # create with flags
Expand Down
2 changes: 2 additions & 0 deletions deno.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 2 additions & 2 deletions skills/linear-cli/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,8 +79,8 @@ linear auth migrate

linear issue
linear issue id
linear issue list
linear issue search
linear issue mine
linear issue query
linear issue title
linear issue start
linear issue view
Expand Down
96 changes: 49 additions & 47 deletions skills/linear-cli/references/issue.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@ Options:
Commands:

id - Print the issue based on the current git branch
list - List your issues
search <term> - Search issues by text
mine, list, l - List your issues
query, q - Query issues with structured filters
title [issueId] - Print the issue title
start [issueId] - Start working on an issue
view, v [issueId] - View issue details (default) or open in browser/app
Expand Down Expand Up @@ -57,76 +57,78 @@ Options:
--workspace <slug> - Target workspace (uses credentials)
```

### list
### mine

> List your issues

```
Usage: linear issue list
Usage: linear issue mine

Description:

List your issues

Options:

-h, --help - Show this help.
--workspace <slug> - Target workspace (uses credentials)
-s, --state <state> - Filter by issue state (can be repeated for multiple states) (Default: [ "unstarted" ], Values: "triage", "backlog",
"unstarted", "started", "completed", "canceled")
--all-states - Show issues from all states
--sort <sort> - Sort order (can also be set via LINEAR_ISSUE_SORT) (Values: "manual", "priority")
--team <team> - Team to list issues for (if not your default team)
--project <project> - Filter by project name
--project-label <projectLabel> - Filter by project label name (shows issues from all projects with this label)
--cycle <cycle> - Filter by cycle name, number, or 'active'
--milestone <milestone> - Filter by project milestone name (requires --project)
-l, --label <label> - Filter by label name (can be repeated for multiple labels)
--limit <limit> - Maximum number of issues to fetch (default: 50, use 0 for unlimited) (Default: 50)
--created-after <date> - Filter issues created after this date (ISO 8601 or YYYY-MM-DD)
--updated-after <date> - Filter issues updated after this date (ISO 8601 or YYYY-MM-DD)
-w, --web - Open in web browser
-a, --app - Open in Linear.app
--no-pager - Disable automatic paging for long output
```

### query

> Query issues with structured filters

```
Usage: linear issue query

Description:

Query issues with structured filters

Options:

-h, --help - Show this help.
--workspace <slug> - Target workspace (uses credentials)
-s, --state <state> - Filter by issue state (can be repeated for multiple states) (Default: [ "unstarted" ], Values: "triage", "backlog",
"unstarted", "started", "completed", "canceled")
--all-states - Show issues from all states
--search <term> - Full-text search term
--search-comments - Also search inside issue comments (requires --search)
--team <team> - Filter by team key (can be repeated for multiple teams)
--all-teams - Query across all teams
-s, --state <state> - Filter by issue state (can be repeated for multiple states) (Values: "triage", "backlog", "unstarted", "started",
"completed", "canceled")
--all-states - Show issues from all states (this is the default)
--assignee <assignee> - Filter by assignee (username)
-A, --all-assignees - Show issues for all assignees
-A, --all-assignees - Show issues for all assignees (this is the default)
-U, --unassigned - Show only unassigned issues
--sort <sort> - Sort order (can also be set via LINEAR_ISSUE_SORT) (Values: "manual", "priority")
--team <team> - Team to list issues for (if not your default team)
--sort <sort> - Sort order: manual or priority (default: priority, not available with --search) (Values: "manual", "priority")
--project <project> - Filter by project name
--project-label <projectLabel> - Filter by project label name (shows issues from all projects with this label)
--cycle <cycle> - Filter by cycle name, number, or 'active'
--milestone <milestone> - Filter by project milestone name (requires --project)
-l, --label <label> - Filter by label name (can be repeated for multiple labels)
--limit <limit> - Maximum number of issues to fetch (default: 50, use 0 for unlimited) (Default: 50)
--limit <limit> - Maximum number of issues to fetch (default: 50, use 0 for unlimited) (Default: 50)
--created-after <date> - Filter issues created after this date (ISO 8601 or YYYY-MM-DD)
--updated-after <date> - Filter issues updated after this date (ISO 8601 or YYYY-MM-DD)
-w, --web - Open in web browser
-a, --app - Open in Linear.app
--include-archived - Include archived issues
-j, --json - Output results as JSON
--no-pager - Disable automatic paging for long output
```

### search

> Search issues by text

```
Usage: linear issue search <term>

Description:

Search issues by text

Options:

-h, --help - Show this help.
--workspace <slug> - Target workspace (uses credentials)
--team <team> - Team to search in
--all-teams - Search across all teams
-s, --state <state> - Filter by issue state (can be repeated for multiple states) (Values: "triage", "backlog", "unstarted", "started",
"completed", "canceled")
--assignee <assignee> - Filter by assignee (username)
-U, --unassigned - Show only unassigned issues
--project <project> - Filter by project name
--project-label <projectLabel> - Filter by project label name (shows issues from all projects with this label)
-l, --label <label> - Filter by label name (can be repeated for multiple labels)
--include-comments - Search associated comments too
--include-archived - Include archived issues
--created-after <date> - Filter issues created after this date (ISO 8601 or YYYY-MM-DD)
--updated-after <date> - Filter issues updated after this date (ISO 8601 or YYYY-MM-DD)
--order-by <orderBy> - Use the API's supported search ordering (Values: "createdAt", "updatedAt")
--limit <limit> - Maximum number of results to fetch (default: 20, use 0 for unlimited) (Default: 20)
--no-pager - Disable automatic paging for long output
-j, --json - Output search results as JSON
```

### title

> Print the issue title
Expand Down
Loading
Loading