Linear Task Manager CLI for AI Coding Agents

project_name: "WebApp Redesign", target_ai_model: "Claude Code"

### 1. CLI Architecture Overview **Core Command Structure**: `linear-cli <action> <resource> [options]` - Actions: create, get, update, delete, list - Resources: issue, comment, project, team - Global flags: --json, --team-id, --project-id **Authentication Method**: Personal API key stored in ~/.linear-cli/config.json with automatic team detection and workspace mapping. ### 2. Command Specifications **Create Issue**: `linear-cli create issue --title "Bug fix" --description "Details" --priority high` Output: `{"id": "ISS-123", "url": "https://linear.app/team/issue/ISS-123", "status": "created"}` **Update Status**: `linear-cli update issue ISS-123 --status "In Progress" --assignee "[email protected]"` ### 3. Implementation Code ```python #!/usr/bin/env python3 import click import requests import json from pathlib import Path @click.group() def cli(): """Linear CLI for AI Coding Agents""" pass @cli.command() @click.option('--title', required=True) @click.option('--description') def create_issue(title, description): # Implementation with Linear GraphQL API pass ``` ### 4. AI Agent Usage Examples Claude Code can execute: `linear-cli create issue --title "$(git log -1 --pretty=%s)" --description "Auto-generated from commit"` to automatically create issues from git commits.