linear-sdk-cli 0.1.0

package/skills/linear-sdk-cli/references/project.md

@@ -0,0 +1,234 @@
+# linear project
+
+> Work with projects
+
+Group alias: `p`
+
+_Generated from `linear commands --json`. `linear project --help` (or `<subcommand> --help`) is authoritative._
+
+Every command also accepts the global flags `-j/--json`, `--no-input`, `-y/--yes`, `-q/--quiet`, `--workspace <slug>`, `--api-key <key>`, `-t/--team <key>`, `-n/--limit <n>`, `--all`, `-f/--fields <a,b,c>`, `--no-ansi` (alias `--no-color`), and `--debug`. Only command-specific options are listed below.
+
+### `linear project`
+
+Work with projects
+
+Aliases: `p`
+
+```
+linear project [options]
+```
+
+**Output (`--json`)**: a bare object — runs `project view` by default
+
+```text
+id: string
+name: string
+description: string | null
+content: string | null
+labels: Array<{id: string, name: string}>
+state: string | null
+status: {id: string, name: string, type: string} | null
+health: string | null
+progress: number | null
+priority: number
+priorityLabel: string
+url: string
+startDate: string | null
+targetDate: string | null
+createdAt: string
+updatedAt: string
+completedAt: string | null
+archivedAt: string | null
+lead: {id: string, displayName: string, email: string} | null
+teams: Array<{id: string, key: string, name: string}>
+members: Array<{id: string, displayName: string, email: string}>
+```
+
+### `linear project archive`
+
+Archive a project
+
+```
+linear project archive [options] <id>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+archived: boolean
+```
+
+### `linear project create`
+
+Create a new project
+
+Aliases: `new`
+
+```
+linear project create [options]
+```
+
+| Option                      | Description                                    |
+| --------------------------- | ---------------------------------------------- |
+| `--name <name>`             | project name                                   |
+| `-d, --description <text>`  | project description (one-line summary)         |
+| `--description-file <path>` | read description from a file ('-' = stdin)     |
+| `--content <text>`          | project content (markdown body)                |
+| `--content-file <path>`     | read content from a file ('-' = stdin)         |
+| `--teams <key>`             | team (repeatable / comma-separated)            |
+| `-t, --team <key>`          | same as --teams (repeatable / comma-separated) |
+| `--lead <who>`              | project lead (me\|email\|name\|id)             |
+| `--member <who>`            | project member (repeatable / comma-separated)  |
+| `--state <name>`            | initial status (name, type, or id)             |
+| `--start <date>`            | planned start date (YYYY-MM-DD)                |
+| `--target <date>`           | planned target date (YYYY-MM-DD)               |
+| `-P, --priority <0-4>`      | priority (0 none, 1 urgent … 4 low)            |
+| `-l, --label <name>`        | project label (repeatable / comma-separated)   |
+| `--icon <name>`             | Linear icon name, capitalized (e.g. Rocket)    |
+| `--color <hex>`             | project color (e.g. #EB5757)                   |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+url: string
+```
+
+### `linear project delete`
+
+Delete (trash) a project — `archive` keeps it, read-only
+
+Aliases: `rm`
+
+```
+linear project delete [options] <id>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+deleted: boolean
+```
+
+### `linear project list`
+
+List projects with filters (the default team's unless --all-teams)
+
+Aliases: `ls`
+
+```
+linear project list [options]
+```
+
+| Option           | Description                                           |
+| ---------------- | ----------------------------------------------------- |
+| `--state <name>` | filter by status name or type (e.g. 'In QA', started) |
+| `--all-teams`    | every team's projects, ignoring the default team      |
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+name: string
+state: string | null
+progress: number | null
+url: string
+startDate: string | null
+targetDate: string | null
+status: {name: string} | null
+lead: {displayName: string} | null
+```
+
+### `linear project milestones`
+
+List a project's milestones
+
+```
+linear project milestones [options] <id>
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+name: string
+targetDate: string | null
+progress: number | null
+```
+
+### `linear project update`
+
+Update a project
+
+Aliases: `edit`
+
+```
+linear project update [options] <id>
+```
+
+| Option                      | Description                                        |
+| --------------------------- | -------------------------------------------------- |
+| `--name <name>`             | new name                                           |
+| `-d, --description <text>`  | new description (one-line summary)                 |
+| `--description-file <path>` | read description from a file ('-' = stdin)         |
+| `--content <text>`          | new content (markdown body)                        |
+| `--content-file <path>`     | read content from a file ('-' = stdin)             |
+| `--teams <key>`             | set teams (repeatable / comma-separated)           |
+| `--lead <who>`              | project lead (me\|email\|name\|id)                 |
+| `--member <who>`            | replace the members (repeatable / comma-separated) |
+| `--state <name>`            | status (name, type, or id)                         |
+| `--start <date>`            | planned start date (YYYY-MM-DD)                    |
+| `--target <date>`           | planned target date (YYYY-MM-DD)                   |
+| `-P, --priority <0-4>`      | priority (0 none, 1 urgent … 4 low)                |
+| `-l, --label <name>`        | replace the labels (repeatable / comma-separated)  |
+| `--icon <name>`             | Linear icon name, capitalized (e.g. Rocket)        |
+| `--color <hex>`             | project color (e.g. #EB5757)                       |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+url: string
+```
+
+### `linear project view`
+
+Show a project (by name or id)
+
+Aliases: `show`
+
+```
+linear project view [options] <id>
+```
+
+**Output (`--json`)**: a bare object
+
+```text
+id: string
+name: string
+description: string | null
+content: string | null
+labels: Array<{id: string, name: string}>
+state: string | null
+status: {id: string, name: string, type: string} | null
+health: string | null
+progress: number | null
+priority: number
+priorityLabel: string
+url: string
+startDate: string | null
+targetDate: string | null
+createdAt: string
+updatedAt: string
+completedAt: string | null
+archivedAt: string | null
+lead: {id: string, displayName: string, email: string} | null
+teams: Array<{id: string, key: string, name: string}>
+members: Array<{id: string, displayName: string, email: string}>
+```

package/skills/linear-sdk-cli/references/roadmap.md

@@ -0,0 +1,150 @@
+# linear roadmap
+
+> Work with roadmaps
+
+Group alias: `rm`
+
+_Generated from `linear commands --json`. `linear roadmap --help` (or `<subcommand> --help`) is authoritative._
+
+Every command also accepts the global flags `-j/--json`, `--no-input`, `-y/--yes`, `-q/--quiet`, `--workspace <slug>`, `--api-key <key>`, `-t/--team <key>`, `-n/--limit <n>`, `--all`, `-f/--fields <a,b,c>`, `--no-ansi` (alias `--no-color`), and `--debug`. Only command-specific options are listed below.
+
+### `linear roadmap`
+
+Work with roadmaps
+
+Aliases: `rm`
+
+```
+linear roadmap [options]
+```
+
+**Output (`--json`)**: a bare object — runs `roadmap view` by default
+
+```text
+id: string
+name: string
+description: string | null
+color: string | null
+url: string
+slugId: string
+owner: string | null
+creator: string | null
+createdAt: string
+updatedAt: string
+projects: string[]
+```
+
+### `linear roadmap create`
+
+Create a new roadmap
+
+Aliases: `new`
+
+```
+linear roadmap create [options]
+```
+
+| Option                      | Description                                |
+| --------------------------- | ------------------------------------------ |
+| `--name <name>`             | roadmap name                               |
+| `-d, --description <text>`  | roadmap description                        |
+| `--description-file <path>` | read description from a file ('-' = stdin) |
+| `--owner <who>`             | roadmap owner (me\|email\|name\|id)        |
+| `--color <hex>`             | roadmap color (e.g. #5e6ad2)               |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+url: string
+```
+
+### `linear roadmap delete`
+
+Delete a roadmap
+
+Aliases: `rm`
+
+```
+linear roadmap delete [options] <id>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+deleted: boolean
+```
+
+### `linear roadmap list`
+
+List roadmaps
+
+Aliases: `ls`
+
+```
+linear roadmap list [options]
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+name: string
+description: string | null
+url: string
+```
+
+### `linear roadmap update`
+
+Update a roadmap
+
+Aliases: `edit`
+
+```
+linear roadmap update [options] <id>
+```
+
+| Option                      | Description                                |
+| --------------------------- | ------------------------------------------ |
+| `--name <name>`             | new name                                   |
+| `-d, --description <text>`  | new description                            |
+| `--description-file <path>` | read description from a file ('-' = stdin) |
+| `--owner <who>`             | roadmap owner (me\|email\|name\|id)        |
+| `--color <hex>`             | roadmap color (e.g. #5e6ad2)               |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+url: string
+```
+
+### `linear roadmap view`
+
+Show a roadmap (by name or id)
+
+Aliases: `show`
+
+```
+linear roadmap view [options] <id>
+```
+
+**Output (`--json`)**: a bare object
+
+```text
+id: string
+name: string
+description: string | null
+color: string | null
+url: string
+slugId: string
+owner: string | null
+creator: string | null
+createdAt: string
+updatedAt: string
+projects: string[]
+```

package/skills/linear-sdk-cli/references/schema.md

@@ -0,0 +1,21 @@
+# linear schema
+
+> Print the Linear GraphQL schema as SDL (--json prints raw introspection)
+
+_Generated from `linear commands --json`. `linear schema --help` (or `<subcommand> --help`) is authoritative._
+
+Every command also accepts the global flags `-j/--json`, `--no-input`, `-y/--yes`, `-q/--quiet`, `--workspace <slug>`, `--api-key <key>`, `-t/--team <key>`, `-n/--limit <n>`, `--all`, `-f/--fields <a,b,c>`, `--no-ansi` (alias `--no-color`), and `--debug`. Only command-specific options are listed below.
+
+### `linear schema`
+
+Print the Linear GraphQL schema as SDL (--json prints raw introspection)
+
+```
+linear schema [options]
+```
+
+| Option                | Description                       |
+| --------------------- | --------------------------------- |
+| `-o, --output <file>` | write to a file instead of stdout |
+
+**Output (`--json`)**: raw JSON (keys depend on the request) — the GraphQL introspection result ({__schema: …}); with -o <file> it is written there and stdout stays empty

package/skills/linear-sdk-cli/references/state.md

@@ -0,0 +1,61 @@
+# linear state
+
+> Inspect workflow states
+
+Group alias: `st`
+
+_Generated from `linear commands --json`. `linear state --help` (or `<subcommand> --help`) is authoritative._
+
+Every command also accepts the global flags `-j/--json`, `--no-input`, `-y/--yes`, `-q/--quiet`, `--workspace <slug>`, `--api-key <key>`, `-t/--team <key>`, `-n/--limit <n>`, `--all`, `-f/--fields <a,b,c>`, `--no-ansi` (alias `--no-color`), and `--debug`. Only command-specific options are listed below.
+
+### `linear state`
+
+Inspect workflow states
+
+Aliases: `st`
+
+```
+linear state [options]
+```
+
+### `linear state list`
+
+List a team's workflow states (defaults to the configured team)
+
+Aliases: `ls`
+
+```
+linear state list [options] [team]
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+name: string
+type: string
+position: number
+color: string
+```
+
+### `linear state view`
+
+Show a workflow state (by id, or by name/type within --team / the default team)
+
+```
+linear state view [options] <id>
+```
+
+**Output (`--json`)**: a bare object
+
+```text
+id: string
+name: string
+type: string
+position: number
+color: string
+description: string | null
+team: string | null
+createdAt: string
+updatedAt: string
+```

package/skills/linear-sdk-cli/references/team.md

@@ -0,0 +1,227 @@
+# linear team
+
+> Inspect and manage teams
+
+Group alias: `t`
+
+_Generated from `linear commands --json`. `linear team --help` (or `<subcommand> --help`) is authoritative._
+
+Every command also accepts the global flags `-j/--json`, `--no-input`, `-y/--yes`, `-q/--quiet`, `--workspace <slug>`, `--api-key <key>`, `-t/--team <key>`, `-n/--limit <n>`, `--all`, `-f/--fields <a,b,c>`, `--no-ansi` (alias `--no-color`), and `--debug`. Only command-specific options are listed below.
+
+### `linear team`
+
+Inspect and manage teams
+
+Aliases: `t`
+
+```
+linear team [options]
+```
+
+### `linear team create`
+
+Create a new team
+
+Aliases: `new`
+
+```
+linear team create [options]
+```
+
+| Option                     | Description                                             |
+| -------------------------- | ------------------------------------------------------- |
+| `--name <name>`            | team name                                               |
+| `--key <key>`              | team key (e.g. ENG); generated from the name if omitted |
+| `-d, --description <text>` | team description                                        |
+| `--private`                | make the team private (members only)                    |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+key: string
+name: string
+```
+
+### `linear team cycles`
+
+List a team's cycles
+
+```
+linear team cycles [options] [key]
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+number: number
+name: string | null
+startsAt: string | null
+endsAt: string | null
+```
+
+### `linear team delete`
+
+Delete a team (admin); its issues go with it unless --move-issues
+
+Aliases: `rm`
+
+```
+linear team delete [options] <key>
+```
+
+| Option                 | Description                                  |
+| ---------------------- | -------------------------------------------- |
+| `--move-issues <team>` | move the team's issues to another team first |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+key: string
+name: string
+deleted: boolean
+movedIssues: number
+movedTo: {id: string, key: string, name: string} | null
+```
+
+### `linear team id`
+
+Print a team's UUID (defaults to the configured team)
+
+```
+linear team id [options] [key]
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+key: string
+name: string
+```
+
+### `linear team labels`
+
+List a team's labels
+
+```
+linear team labels [options] [key]
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+name: string
+color: string
+```
+
+### `linear team list`
+
+List all teams
+
+Aliases: `ls`
+
+```
+linear team list [options]
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+key: string
+name: string
+```
+
+### `linear team members`
+
+List a team's members
+
+```
+linear team members [options] [key]
+```
+
+| Option               | Description                                     |
+| -------------------- | ----------------------------------------------- |
+| `--include-disabled` | include deactivated users (excluded by default) |
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+displayName: string
+name: string
+email: string
+active: boolean
+```
+
+### `linear team states`
+
+List a team's workflow states
+
+```
+linear team states [options] [key]
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+name: string
+type: string
+color: string
+position: number
+```
+
+### `linear team update`
+
+Update a team (defaults to the configured team)
+
+Aliases: `edit`
+
+```
+linear team update [options] [key]
+```
+
+| Option                     | Description          |
+| -------------------------- | -------------------- |
+| `--name <name>`            | new team name        |
+| `--key <key>`              | new team key         |
+| `-d, --description <text>` | new team description |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+key: string
+name: string
+```
+
+### `linear team view`
+
+Show a team (defaults to the configured team)
+
+```
+linear team view [options] [key]
+```
+
+**Output (`--json`)**: a bare object
+
+```text
+id: string
+key: string
+name: string
+description: string | null
+private: boolean
+cyclesEnabled: boolean
+timezone: string | null
+color: string | null
+icon: string | null
+issueCount: number
+memberCount: number
+createdAt: string
+updatedAt: string
+```