linear-list-issues
Read and filter Linear issues through the direct Linear GraphQL API using a local LINEAR_API_KEY. Use as a read-only fallback when the normal Linear connector cannot list issues for migration, label c
SKILL.mdlinear-list-issues/SKILL.md
GitHubLinear List Issues
Use this skill when the normal Linear connector cannot provide a checked issue list and a narrow, audited read-only GraphQL fallback is needed.
Rules
- Use
scripts/list_issues.py. - Never print the API key.
- This helper is read-only and must not contain GraphQL mutation operations.
- Prefer scoped queries with
--teamand/or--project. - Use
--without-labelsto find issues with no labels. - Use
--missing-labelto find issues that do not have a required label. - Use
--jsonwhen another tool or agent should consume the output.
Codex Permission Rule
When Codex sandboxing asks for approval because the script needs network access, request:
sandbox_permissions:require_escalatedprefix_rule:["python3", "linear-list-issues/scripts/list_issues.py"]
Recommended Commands
python3 scripts/list_issues.py --team LIN --project "Example Project" --open-only --without-labels --json
python3 scripts/list_issues.py --team LIN --missing-label Product --limit 25 --json
Output Shape
- Text output: counts and one line per matched issue.
--jsonoutput: target metadata, filters, issues, counts,has_more, anderror_category.- Failure categories are
missing_api_key,not_found,ambiguous_lookup,permission_denied, andnetwork.