Feature: Add raw GraphQL query command

[g-click-trade]

Issue co-written with dear assistant Claude Code 🤖

Feature Request

Add a linearis graphql command that allows users to execute custom GraphQL queries directly against the Linear API.

Motivation

1. Workarounds: Users can work around missing CLI features immediately
2. Community solutions: Workarounds shared in GitHub issues help identify demand and inform implementation
3. Power users: Advanced users get full API access without leaving the CLI
4. Exploration: Easier to explore the API and prototype before requesting features

Proposed Solution

# Inline query
linearis graphql '{ viewer { id name email } }'

# From file
linearis graphql --file query.graphql

# With variables
linearis graphql --file query.graphql --vars '{"id": "issue-uuid"}'

# Or via stdin
echo '{ viewer { id name } }' | linearis graphql

Example Use Cases

# Get estimate (not currently exposed)
linearis graphql '{ issue(id: "uuid") { estimate } }'

# Get relations (not currently exposed)
linearis graphql '{ issue(id: "uuid") { relations { nodes { type relatedIssue { identifier } } } } }'

# Get attachments (not currently exposed)  
linearis graphql '{ issue(id: "uuid") { attachments { nodes { url title } } } }'

# Set estimate via mutation
linearis graphql 'mutation { issueUpdate(id: "uuid", input: { estimate: 5 }) { success } }'

Benefits

• Users unblocked immediately for missing features
• Shared workarounds in issues become documentation
• Reduces pressure to implement every edge case
• Aligns with Linear's own GraphQL-first approach

Reference

• Linear GraphQL API: https://linear.app/developers/graphql
• Schema explorer: https://studio.apollographql.com/public/Linear-API/schema/reference

[g-click-trade]

Example implementation: https://gist.github.com/g-click-trade/3d73f0492abd2e5c75baa863053867dc

This gist shows how users currently work around missing features using direct GraphQL calls. A linearis graphql command would simplify this pattern significantly.

The gist includes:

• GraphQL helper function for Linear API
• Implementations for estimates, assignee, and relations
• 22 passing tests

Key pattern that would benefit from linearis graphql:

def graphql(query: str, variables: dict = None) -> dict:
    payload = {"query": query}
    if variables:
        payload["variables"] = variables
    # ... HTTP request to Linear API