Menu
Search Linear issues and projects. Use when finding issues, looking up bugs, or searching the backlog.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Execute raw GraphQL queries and mutations against the Linear API. Use for advanced operations not covered by other commands.
Manage issue attachments - link URLs, create, update, delete. Use when attaching files or links to issues.
Manage issue comments - list, create, update, delete. Use when reading or posting comments on issues.
Configure linear-cli - auth (API key + OAuth), workspaces, diagnostics, setup wizard.
Manage Linear sprint cycles - list, create, update, delete, complete. Use when managing cycles.
Mark the current branch's issue as Done. Use as a quick shortcut to close the issue you're working on.
| name | linear-search |
| description | Search Linear issues and projects. Use when finding issues, looking up bugs, or searching the backlog. |
| allowed-tools | Bash |
Search Linear.app issues and projects using linear-cli.
# 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
linear-cli s projects "backend"
# Limit results
linear-cli s projects "api" --limit 10
# JSON output
linear-cli s projects "mobile" --output json
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
--output json for programmatic access--limit to control result counti get for full details