Skip to content

feat: add issue search command #200

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 2, 2026
Merged

feat: add issue search command #200

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
3 changes: 3 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ 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 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 @@ -134,6 +135,8 @@ 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 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
35 changes: 35 additions & 0 deletions skills/linear-cli/references/issue.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ Commands:

id - Print the issue based on the current git branch
list - List your issues
search <term> - Search issues by text
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 @@ -92,6 +93,40 @@ Options:
--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.
-w, --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