linear-sdk-cli 0.1.0

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

@@ -0,0 +1,180 @@
+# linear document
+
+> Work with documents
+
+Group alias: `doc`
+
+_Generated from `linear commands --json`. `linear document --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 document`
+
+Work with documents
+
+Aliases: `doc`
+
+```
+linear document [options]
+```
+
+**Output (`--json`)**: a bare object — runs `document view` by default
+
+```text
+project: {id: string, name: string} | null
+issue: {id: string, identifier: string} | null
+initiative: {id: string, name: string} | null
+team: {id: string, key: string, name: string} | null
+cycle: {id: string, number: number, name: string | null} | null
+release: {id: string, name: string, version: string | null} | null
+id: string
+title: string
+content: string | null
+url: string
+slugId: string
+icon: string | null
+color: string | null
+createdAt: string
+updatedAt: string
+creator: {id: string, displayName: string} | null
+```
+
+### `linear document create`
+
+Create a new document, attached to one target (--project, --issue, --initiative, --team, --cycle, or --release; default: the configured team)
+
+Aliases: `new`
+
+```
+linear document create [options]
+```
+
+| Option                  | Description                                                                    |
+| ----------------------- | ------------------------------------------------------------------------------ |
+| `--title <title>`       | document title                                                                 |
+| `--content <text>`      | document content (markdown body)                                               |
+| `--content-file <path>` | read content from a file ('-' = stdin)                                         |
+| `-p, --project <name>`  | attach to a project (name or id)                                               |
+| `--issue <id>`          | attach to an issue (identifier or id)                                          |
+| `--initiative <name>`   | attach to an initiative (name or id)                                           |
+| `--cycle <n>`           | attach to a cycle (number, name, id, or 'current'; team from --team or config) |
+| `--release <name>`      | attach to a release (name, version, or id)                                     |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+title: string
+url: string
+```
+
+### `linear document delete`
+
+Delete (trash) a document
+
+Aliases: `rm`
+
+```
+linear document delete [options] <id>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+title: string
+deleted: boolean
+```
+
+### `linear document list`
+
+List workspace documents (optionally only those attached to one target)
+
+Aliases: `ls`
+
+```
+linear document list [options]
+```
+
+| Option                 | Description                                                                                     |
+| ---------------------- | ----------------------------------------------------------------------------------------------- |
+| `-p, --project <name>` | only documents attached to a project (name or id)                                               |
+| `--issue <id>`         | only documents attached to an issue (identifier or id)                                          |
+| `--initiative <name>`  | only documents attached to an initiative (name or id)                                           |
+| `--cycle <n>`          | only documents attached to a cycle (number, name, id, or 'current'; team from --team or config) |
+| `--release <name>`     | only documents attached to a release (name, version, or id)                                     |
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+project: {id: string, name: string} | null
+issue: {id: string, identifier: string} | null
+initiative: {id: string, name: string} | null
+team: {id: string, key: string, name: string} | null
+cycle: {id: string, number: number, name: string | null} | null
+release: {id: string, name: string, version: string | null} | null
+id: string
+title: string
+url: string
+updatedAt: string
+```
+
+### `linear document update`
+
+Update a document's title or content, or re-point it to another target
+
+Aliases: `edit`
+
+```
+linear document update [options] <id>
+```
+
+| Option                  | Description                                                                      |
+| ----------------------- | -------------------------------------------------------------------------------- |
+| `--title <title>`       | new title                                                                        |
+| `--content <text>`      | new content (markdown body)                                                      |
+| `--content-file <path>` | read content from a file ('-' = stdin)                                           |
+| `-p, --project <name>`  | re-point to a project (name or id)                                               |
+| `--issue <id>`          | re-point to an issue (identifier or id)                                          |
+| `--initiative <name>`   | re-point to an initiative (name or id)                                           |
+| `--cycle <n>`           | re-point to a cycle (number, name, id, or 'current'; team from --team or config) |
+| `--release <name>`      | re-point to a release (name, version, or id)                                     |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+title: string
+url: string
+```
+
+### `linear document view`
+
+Show a document, including its markdown content
+
+Aliases: `show`
+
+```
+linear document view [options] <id>
+```
+
+**Output (`--json`)**: a bare object
+
+```text
+project: {id: string, name: string} | null
+issue: {id: string, identifier: string} | null
+initiative: {id: string, name: string} | null
+team: {id: string, key: string, name: string} | null
+cycle: {id: string, number: number, name: string | null} | null
+release: {id: string, name: string, version: string | null} | null
+id: string
+title: string
+content: string | null
+url: string
+slugId: string
+icon: string | null
+color: string | null
+createdAt: string
+updatedAt: string
+creator: {id: string, displayName: string} | null
+```

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

@@ -0,0 +1,78 @@
+# linear favorite
+
+> Manage your favorites
+
+Group alias: `fav`
+
+_Generated from `linear commands --json`. `linear favorite --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 favorite`
+
+Manage your favorites
+
+Aliases: `fav`
+
+```
+linear favorite [options]
+```
+
+### `linear favorite add`
+
+Favorite an issue, project, or document (exactly one)
+
+Aliases: `new`
+
+```
+linear favorite add [options]
+```
+
+| Option                 | Description                           |
+| ---------------------- | ------------------------------------- |
+| `--issue <id>`         | issue id or identifier (e.g. TES-123) |
+| `--project <id\|name>` | project name or id                    |
+| `--document <id>`      | document id (UUID)                    |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+type: string
+```
+
+### `linear favorite list`
+
+List your favorites
+
+Aliases: `ls`
+
+```
+linear favorite list [options]
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+type: string
+name: string
+url: string | null
+```
+
+### `linear favorite remove`
+
+Remove a favorite by id
+
+Aliases: `rm`
+
+```
+linear favorite remove [options] <favoriteId>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+removed: boolean
+```

package/skills/linear-sdk-cli/references/initiative-update.md

@@ -0,0 +1,67 @@
+# linear initiative-update
+
+> Post and list initiative status updates
+
+Group alias: `iu`
+
+_Generated from `linear commands --json`. `linear initiative-update --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 initiative-update`
+
+Post and list initiative status updates
+
+Aliases: `iu`
+
+```
+linear initiative-update [options]
+```
+
+### `linear initiative-update create`
+
+Post a status update on an initiative (by name or id)
+
+Aliases: `new`
+
+```
+linear initiative-update create [options] <initiative>
+```
+
+| Option               | Description                         |
+| -------------------- | ----------------------------------- |
+| `--body <text>`      | update body (markdown)              |
+| `--body-file <path>` | read body from a file ('-' = stdin) |
+| `--editor`           | compose the body in $EDITOR         |
+| `--health <state>`   | status health                       |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+createdAt: string
+user: string
+body: string
+health: string | null
+url: string
+```
+
+### `linear initiative-update list`
+
+List an initiative's status updates
+
+Aliases: `ls`
+
+```
+linear initiative-update list [options] <initiative>
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+createdAt: string
+user: string
+body: string
+health: string | null
+```

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

@@ -0,0 +1,256 @@
+# linear initiative
+
+> Work with initiatives
+
+Group alias: `init`
+
+_Generated from `linear commands --json`. `linear initiative --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 initiative`
+
+Work with initiatives
+
+Aliases: `init`
+
+```
+linear initiative [options]
+```
+
+**Output (`--json`)**: a bare object — runs `initiative view` by default
+
+```text
+id: string
+name: string
+description: string | null
+status: string | null
+priority: number
+priorityLabel: string
+labels: string[]
+health: string | null
+targetDate: string | null
+color: string | null
+icon: string | null
+url: string
+createdAt: string
+updatedAt: string
+startedAt: string | null
+completedAt: string | null
+archivedAt: string | null
+owner: string | null
+creator: string | null
+projects: Array<{id: string, name: string, status: {name: string, type: string} | null}>
+```
+
+### `linear initiative add-project`
+
+Link a project to an initiative
+
+```
+linear initiative add-project [options] <initiative> <project>
+```
+
+| Option             | Description                              |
+| ------------------ | ---------------------------------------- |
+| `--sort-order <n>` | position among the initiative's projects |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+initiative: {id: string, name: string}
+project: {id: string, name: string}
+```
+
+### `linear initiative archive`
+
+Archive an initiative
+
+```
+linear initiative archive [options] <id>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+archived: boolean
+```
+
+### `linear initiative create`
+
+Create a new initiative
+
+Aliases: `new`
+
+```
+linear initiative create [options]
+```
+
+| Option                      | Description                                             |
+| --------------------------- | ------------------------------------------------------- |
+| `--name <name>`             | initiative name                                         |
+| `-d, --description <text>`  | initiative description                                  |
+| `--description-file <path>` | read description from a file ('-' = stdin)              |
+| `--target <date>`           | estimated completion date (YYYY-MM-DD)                  |
+| `--owner <who>`             | initiative owner (me\|email\|name\|id)                  |
+| `--status <name>`           | status (Planned, Active, Completed, Canceled, Proposed) |
+| `-P, --priority <0-4>`      | priority (0 none, 1 urgent … 4 low)                     |
+| `-l, --label <name>`        | initiative label (repeatable / comma-separated)         |
+| `--icon <name>`             | Linear icon name, capitalized (e.g. Rocket)             |
+| `--color <hex>`             | initiative color (e.g. #5E6AD2)                         |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+url: string
+```
+
+### `linear initiative delete`
+
+Delete (trash) an initiative
+
+Aliases: `rm`
+
+```
+linear initiative delete [options] <id>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+deleted: boolean
+```
+
+### `linear initiative list`
+
+List workspace initiatives (every status unless --status narrows)
+
+Aliases: `ls`
+
+```
+linear initiative list [options]
+```
+
+| Option            | Description                                                       |
+| ----------------- | ----------------------------------------------------------------- |
+| `--status <name>` | filter by status (Planned, Active, Completed, Canceled, Proposed) |
+| `--owner <who>`   | filter by owner (me\|email\|name\|id)                             |
+| `--archived`      | include archived initiatives                                      |
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+name: string
+status: string | null
+priority: number
+targetDate: string | null
+health: string | null
+url: string
+```
+
+### `linear initiative remove-project`
+
+Unlink a project from an initiative
+
+```
+linear initiative remove-project [options] <initiative> <project>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+initiative: {id: string, name: string}
+project: {id: string, name: string}
+removed: boolean
+```
+
+### `linear initiative unarchive`
+
+Unarchive an initiative
+
+```
+linear initiative unarchive [options] <id>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+archived: boolean
+```
+
+### `linear initiative update`
+
+Update an initiative
+
+Aliases: `edit`
+
+```
+linear initiative update [options] <id>
+```
+
+| Option                      | Description                                             |
+| --------------------------- | ------------------------------------------------------- |
+| `--name <name>`             | new name                                                |
+| `-d, --description <text>`  | new description                                         |
+| `--description-file <path>` | read description from a file ('-' = stdin)              |
+| `--target <date>`           | estimated completion date (YYYY-MM-DD)                  |
+| `--owner <who>`             | initiative owner (me\|email\|name\|id)                  |
+| `--status <name>`           | status (Planned, Active, Completed, Canceled, Proposed) |
+| `-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>`             | initiative color (e.g. #5E6AD2)                         |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+name: string
+url: string
+```
+
+### `linear initiative view`
+
+Show an initiative (by name or id)
+
+Aliases: `show`
+
+```
+linear initiative view [options] <id>
+```
+
+**Output (`--json`)**: a bare object
+
+```text
+id: string
+name: string
+description: string | null
+status: string | null
+priority: number
+priorityLabel: string
+labels: string[]
+health: string | null
+targetDate: string | null
+color: string | null
+icon: string | null
+url: string
+createdAt: string
+updatedAt: string
+startedAt: string | null
+completedAt: string | null
+archivedAt: string | null
+owner: string | null
+creator: string | null
+projects: Array<{id: string, name: string, status: {name: string, type: string} | null}>
+```