Menu
Execute raw GraphQL queries and mutations against the Linear API. Use for advanced operations not covered by other commands.
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
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.
Export Linear data to CSV, Markdown, or JSON. Use when exporting issues or projects.
| name | linear-api |
| description | Execute raw GraphQL queries and mutations against the Linear API. Use for advanced operations not covered by other commands. |
| allowed-tools | Bash |
# Run a query
linear-cli api query '{ viewer { id name email } }'
# Query with variables
linear-cli api query -v teamId=abc '{ team(id: $teamId) { name } }'
# Run a mutation
linear-cli api mutate -v title="Bug" '
mutation($title: String!) {
issueCreate(input: { title: $title, teamId: "..." }) {
issue { id identifier }
}
}
'
# Pipe query from file
cat query.graphql | linear-cli api query -
| Flag | Purpose |
|---|---|
-v key=val | GraphQL variables |
--output json | JSON output |
--compact | Compact JSON |
0=Success, 1=Error, 2=Not found, 3=Auth error