linear-cli-agents 0.1.0

package/oclif.manifest.json

@@ -0,0 +1,549 @@
+{
+  "commands": {
+    "query": {
+      "aliases": [],
+      "args": {},
+      "description": "Execute a raw GraphQL query against the Linear API",
+      "examples": [
+        "<%= config.bin %> query --gql \"query { viewer { id name email } }\"",
+        "<%= config.bin %> query --gql \"query { teams { nodes { id key name } } }\"",
+        "<%= config.bin %> query --gql \"query($id: String!) { issue(id: $id) { title } }\" --variables '{\"id\":\"xxx\"}'"
+      ],
+      "flags": {
+        "gql": {
+          "char": "g",
+          "description": "GraphQL query string",
+          "name": "gql",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "variables": {
+          "char": "v",
+          "description": "JSON object of query variables",
+          "name": "variables",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "timeout": {
+          "char": "t",
+          "description": "Request timeout in seconds (default: 30)",
+          "name": "timeout",
+          "default": 30,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "query",
+      "pluginAlias": "linear-cli-agents",
+      "pluginName": "linear-cli-agents",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "query.js"
+      ]
+    },
+    "schema": {
+      "aliases": [],
+      "args": {
+        "entity": {
+          "description": "Entity name (issues, projects, teams, users, cycles, labels, comments)",
+          "name": "entity",
+          "required": false
+        }
+      },
+      "description": "Show schema information for entities (useful for LLMs to discover available operations)",
+      "examples": [
+        "<%= config.bin %> schema",
+        "<%= config.bin %> schema issues",
+        "<%= config.bin %> schema --full",
+        "<%= config.bin %> schema issues --include-examples"
+      ],
+      "flags": {
+        "full": {
+          "description": "Show full schema for all entities",
+          "name": "full",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "include-examples": {
+          "description": "Include usage examples",
+          "name": "include-examples",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "schema",
+      "pluginAlias": "linear-cli-agents",
+      "pluginName": "linear-cli-agents",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "schema.js"
+      ]
+    },
+    "auth:login": {
+      "aliases": [],
+      "args": {
+        "key": {
+          "description": "Linear API key (alternative to --key flag)",
+          "name": "key",
+          "required": false
+        }
+      },
+      "description": "Authenticate with Linear using an API key",
+      "examples": [
+        "<%= config.bin %> auth login --key lin_api_xxxxx",
+        "LINEAR_API_KEY=lin_api_xxxxx <%= config.bin %> auth login"
+      ],
+      "flags": {
+        "key": {
+          "char": "k",
+          "description": "Linear API key (or set LINEAR_API_KEY env var)",
+          "env": "LINEAR_API_KEY",
+          "name": "key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:login",
+      "pluginAlias": "linear-cli-agents",
+      "pluginName": "linear-cli-agents",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "login.js"
+      ]
+    },
+    "auth:logout": {
+      "aliases": [],
+      "args": {},
+      "description": "Remove stored Linear API key",
+      "examples": [
+        "<%= config.bin %> auth logout"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:logout",
+      "pluginAlias": "linear-cli-agents",
+      "pluginName": "linear-cli-agents",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "logout.js"
+      ]
+    },
+    "auth:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Check authentication status",
+      "examples": [
+        "<%= config.bin %> auth status"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:status",
+      "pluginAlias": "linear-cli-agents",
+      "pluginName": "linear-cli-agents",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "status.js"
+      ]
+    },
+    "issues:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a new issue",
+      "examples": [
+        "<%= config.bin %> issues create --input '{\"title\":\"Bug fix\",\"teamId\":\"xxx\"}'",
+        "<%= config.bin %> issues create --title \"New feature\" --team-id xxx",
+        "<%= config.bin %> issues create --title \"Task\" --team-id xxx --description \"Details here\" --priority 2"
+      ],
+      "flags": {
+        "input": {
+          "char": "i",
+          "description": "JSON input object (IssueCreateInput)",
+          "exclusive": [
+            "title"
+          ],
+          "name": "input",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "title": {
+          "description": "Issue title",
+          "exclusive": [
+            "input"
+          ],
+          "name": "title",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "team-id": {
+          "description": "Team ID",
+          "name": "team-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "char": "d",
+          "description": "Issue description (markdown supported)",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "priority": {
+          "char": "p",
+          "description": "Priority (0=none, 1=urgent, 2=high, 3=medium, 4=low)",
+          "name": "priority",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "assignee-id": {
+          "description": "Assignee user ID",
+          "name": "assignee-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "state-id": {
+          "description": "State ID",
+          "name": "state-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project-id": {
+          "description": "Project ID",
+          "name": "project-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "estimate": {
+          "description": "Estimate points",
+          "name": "estimate",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "label-ids": {
+          "description": "Comma-separated label IDs",
+          "name": "label-ids",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "issues:create",
+      "pluginAlias": "linear-cli-agents",
+      "pluginName": "linear-cli-agents",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "issues",
+        "create.js"
+      ]
+    },
+    "issues:delete": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Issue ID or identifier (e.g., ENG-123)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Delete an issue (moves to trash)",
+      "examples": [
+        "<%= config.bin %> issues delete abc123",
+        "<%= config.bin %> issues delete ENG-123",
+        "<%= config.bin %> issues delete ENG-123 --permanent"
+      ],
+      "flags": {
+        "permanent": {
+          "description": "Permanently delete (cannot be undone)",
+          "name": "permanent",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "issues:delete",
+      "pluginAlias": "linear-cli-agents",
+      "pluginName": "linear-cli-agents",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "issues",
+        "delete.js"
+      ]
+    },
+    "issues:get": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Issue ID or identifier (e.g., ENG-123)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a single issue by ID or identifier",
+      "examples": [
+        "<%= config.bin %> issues get abc123",
+        "<%= config.bin %> issues get ENG-123"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "issues:get",
+      "pluginAlias": "linear-cli-agents",
+      "pluginName": "linear-cli-agents",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "issues",
+        "get.js"
+      ]
+    },
+    "issues:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List issues with optional filtering",
+      "examples": [
+        "<%= config.bin %> issues list",
+        "<%= config.bin %> issues list --team ENG",
+        "<%= config.bin %> issues list --assignee me",
+        "<%= config.bin %> issues list --filter '{\"state\":{\"name\":{\"eq\":\"In Progress\"}}}'",
+        "<%= config.bin %> issues list --first 50 --after cursor123"
+      ],
+      "flags": {
+        "team": {
+          "char": "t",
+          "description": "Filter by team key (e.g., ENG)",
+          "name": "team",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "assignee": {
+          "char": "a",
+          "description": "Filter by assignee (use \"me\" for current user)",
+          "name": "assignee",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "state": {
+          "char": "s",
+          "description": "Filter by state name (e.g., \"In Progress\")",
+          "name": "state",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filter": {
+          "char": "f",
+          "description": "JSON filter object (IssueFilter from Linear SDK)",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "first": {
+          "description": "Number of issues to fetch (default: 50)",
+          "name": "first",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "after": {
+          "description": "Cursor for pagination",
+          "name": "after",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "issues:list",
+      "pluginAlias": "linear-cli-agents",
+      "pluginName": "linear-cli-agents",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "issues",
+        "list.js"
+      ]
+    },
+    "issues:update": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Issue ID or identifier (e.g., ENG-123)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update an existing issue",
+      "examples": [
+        "<%= config.bin %> issues update abc123 --input '{\"title\":\"Updated title\"}'",
+        "<%= config.bin %> issues update ENG-123 --title \"New title\"",
+        "<%= config.bin %> issues update ENG-123 --state-id xxx --assignee-id yyy"
+      ],
+      "flags": {
+        "input": {
+          "char": "i",
+          "description": "JSON input object (IssueUpdateInput)",
+          "exclusive": [
+            "title",
+            "description",
+            "priority",
+            "assignee-id",
+            "state-id"
+          ],
+          "name": "input",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "title": {
+          "description": "Issue title",
+          "name": "title",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "char": "d",
+          "description": "Issue description (markdown supported)",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "priority": {
+          "char": "p",
+          "description": "Priority (0=none, 1=urgent, 2=high, 3=medium, 4=low)",
+          "name": "priority",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "assignee-id": {
+          "description": "Assignee user ID (use empty string to unassign)",
+          "name": "assignee-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "state-id": {
+          "description": "State ID",
+          "name": "state-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project-id": {
+          "description": "Project ID",
+          "name": "project-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "estimate": {
+          "description": "Estimate points",
+          "name": "estimate",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "label-ids": {
+          "description": "Comma-separated label IDs (replaces existing labels)",
+          "name": "label-ids",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "issues:update",
+      "pluginAlias": "linear-cli-agents",
+      "pluginName": "linear-cli-agents",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "issues",
+        "update.js"
+      ]
+    }
+  },
+  "version": "0.1.0"
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "linear-cli-agents",
+  "version": "0.1.0",
+  "description": "CLI for interacting with Linear, designed for LLMs and agents",
+  "author": "Nacho",
+  "bin": {
+    "linear": "./bin/run.js"
+  },
+  "homepage": "https://github.com/nacho/linear-cli",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "type": "module",
+  "repository": "nacho/linear-cli",
+  "files": [
+    "/bin",
+    "/dist",
+    "/oclif.manifest.json"
+  ],
+  "dependencies": {
+    "@linear/sdk": "^29.0.0",
+    "@oclif/core": "^4.3.0",
+    "@oclif/plugin-help": "^6.2.0"
+  },
+  "devDependencies": {
+    "@oclif/prettier-config": "^0.2.1",
+    "@oclif/test": "^4.1.0",
+    "@types/node": "^22.0.0",
+    "oclif": "^4.17.0",
+    "shx": "^0.3.4",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "oclif": {
+    "bin": "linear",
+    "dirname": "linear-cli",
+    "commands": "./dist/commands",
+    "plugins": [
+      "@oclif/plugin-help"
+    ],
+    "topicSeparator": " ",
+    "topics": {
+      "auth": {
+        "description": "Authentication commands"
+      },
+      "issues": {
+        "description": "Issue management commands"
+      }
+    }
+  },
+  "scripts": {
+    "build": "shx rm -rf dist && tsc -b",
+    "lint": "tsc --noEmit",
+    "postpack": "shx rm -f oclif.manifest.json",
+    "prepack": "pnpm run build && oclif manifest && oclif readme",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "linear",
+    "cli",
+    "llm",
+    "agent",
+    "project-management"
+  ],
+  "packageManager": "pnpm@10.18.1"
+}