About linear-search
linear-search is a command-line skill for searching Linear issues and projects. It supports text queries, result limits, and JSON output, with related commands available for retrieving issue details and comments.
Key features
- 01Search issues by text
- 02Search projects by text
- 03Limit result counts
- 04Emit JSON results
- 05Retrieve issue details and comments
Use cases
- 01Find issues mentioning a specific problem
- 02Locate projects by topic
- 03Pass search results to a script as JSON
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ nesszer/ linear-cli --skill linear-searchAfter installing, type/linear-searchin Claude Code to confirm it loaded.
Details
From the project READMELinear Search
Search Linear.app issues and projects using linear-cli.
Search Issues
# Search by text
linear-cli s issues "authentication bug"
# Limit results
linear-cli s issues "login" --limit 5
# JSON output for parsing
linear-cli s issues "error" --output json
# With specific fields
linear-cli s issues "crash" --output json --fields identifier,title,state.name
Search Projects
# Search projects
linear-cli s projects "backend"
# Limit results
linear-cli s projects "api" --limit 10
# JSON output
linear-cli s projects "mobile" --output json
Filter Results
After searching, get details on specific issues:
# Get issue details
linear-cli i get LIN-123 --output json
# Get comments
linear-cli cm list LIN-123 --output json
# List issues by team
linear-cli i list -t ENG --output json
# List issues by status
linear-cli i list -s "In Progress" --output json
Tips
- Search is case-insensitive
- Searches issue titles and descriptions
- Use
--output jsonfor programmatic access - Use
--limitto control result count - Combine with
i getfor full details
Comments
Markdown supported