linear-sdk-cli 0.1.0

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

@@ -0,0 +1,174 @@
+# linear auth
+
+> Manage authentication
+
+_Generated from `linear commands --json`. `linear auth --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 auth`
+
+Manage authentication
+
+```
+linear auth [options]
+```
+
+### `linear auth adopt`
+
+Adopt an existing named credential from the shared OS keyring
+
+```
+linear auth adopt [options] <slug>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+success: boolean
+workspace: string
+user: {id: string, name: string, email: string}
+storage: string
+path: string
+```
+
+### `linear auth default`
+
+Set the default workspace credential
+
+```
+linear auth default [options] <slug>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+success: boolean
+default_workspace: string
+path: string
+```
+
+### `linear auth list`
+
+List configured workspace credentials
+
+Aliases: `ls`
+
+```
+linear auth list [options]
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+slug: string
+isDefault: boolean
+storage: string
+```
+
+### `linear auth login`
+
+Validate and store a Linear API key for a workspace
+
+```
+linear auth login [options]
+```
+
+| Option        | Description                                                           |
+| ------------- | --------------------------------------------------------------------- |
+| `--key <key>` | API key (otherwise prompted; '-' reads it from stdin)                 |
+| `--plaintext` | Store the key in the config file (0600) instead of the system keyring |
+
+**Output (`--json`)**: a receipt object
+
+```text
+success: boolean
+workspace: string
+user: {id: string, name: string, email: string}
+storage: string
+path: string
+```
+
+### `linear auth logout`
+
+Remove a stored workspace credential (select with --workspace <slug>)
+
+```
+linear auth logout [options]
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+success: boolean
+workspace: string
+removed: boolean
+```
+
+### `linear auth migrate`
+
+Move plaintext credentials from the config file into the system keyring
+
+```
+linear auth migrate [options]
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+success: boolean
+migrated: string[]
+path: string
+```
+
+### `linear auth status`
+
+Show where the API key is resolved from (key redacted)
+
+```
+linear auth status [options]
+```
+
+**Output (`--json`)**: a bare object
+
+```text
+authenticated: boolean
+source: string
+workspace: string | null
+key: string
+keyring: string | null
+```
+
+### `linear auth token`
+
+Print the resolved API key for the active workspace (for scripting)
+
+```
+linear auth token [options]
+```
+
+**Output (`--json`)**: a bare object
+
+```text
+apiKey: string
+workspace: string | null
+```
+
+### `linear auth whoami`
+
+Show the authenticated user
+
+```
+linear auth whoami [options]
+```
+
+**Output (`--json`)**: a bare object
+
+```text
+id: string
+name: string
+displayName: string
+email: string
+admin: boolean
+organization: {id: string, name: string, urlKey: string}
+```

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

@@ -0,0 +1,37 @@
+# linear commands
+
+> List every command in a machine-readable tree, or describe one (for scripts/agents)
+
+_Generated from `linear commands --json`. `linear commands --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 commands`
+
+List every command in a machine-readable tree, or describe one (for scripts/agents)
+
+```
+linear commands [options] [path...]
+```
+
+**Output (`--json`)**: a bare array of objects — `output` is absent on a group that only holds subcommands
+
+```text
+path: string
+description: string
+aliases: string[]
+arguments: Array<{name: string, required: boolean, variadic: boolean}>
+options: Array<{flags: string, description: string, attribute: string, valueRequired: boolean, valueOptional: boolean, variadic: boolean, choices?: string[], defaultValue?: unknown, global: boolean, applicable: boolean}>
+output?: {kind: string, fields?: object, note?: string, variants?: object}
+```
+
+With `[path]`: a bare object
+
+```text
+path: string
+description: string
+aliases: string[]
+arguments: Array<{name: string, required: boolean, variadic: boolean}>
+options: Array<{flags: string, description: string, attribute: string, valueRequired: boolean, valueOptional: boolean, variadic: boolean, choices?: string[], defaultValue?: unknown, global: boolean, applicable: boolean}>
+output?: {kind: string, fields?: object, note?: string, variants?: object}
+```

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

@@ -0,0 +1,154 @@
+# linear comment
+
+> Manage comments
+
+Group alias: `cm`
+
+_Generated from `linear commands --json`. `linear comment --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 comment`
+
+Manage comments
+
+Aliases: `cm`
+
+```
+linear comment [options]
+```
+
+### `linear comment add`
+
+Add a comment to an issue (images uploaded with --attach render inline)
+
+```
+linear comment add [options] <issue> [body]
+```
+
+| Option               | Description                                                                               |
+| -------------------- | ----------------------------------------------------------------------------------------- |
+| `--body-file <path>` | read comment body from a file ('-' = stdin)                                               |
+| `--attach <file>`    | upload a file and embed it in the comment (images inline; repeatable; private by default) |
+| `--public`           | upload the attachments to public, world-readable URLs (raster images only)                |
+
+**Output (`--json`)**: a receipt object — `attachments` only with --attach
+
+```text
+id: string
+issue: string
+url: string
+attachments?: Array<{filename: string, assetUrl: string, contentType: string, size: number}>
+```
+
+### `linear comment delete`
+
+Delete a comment
+
+Aliases: `rm`
+
+```
+linear comment delete [options] <commentId>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+deleted: boolean
+```
+
+### `linear comment list`
+
+List comments on an issue
+
+Aliases: `ls`
+
+```
+linear comment list [options] <issue>
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+body: string
+user: {id: string, displayName: string} | null
+createdAt: string
+editedAt: string | null
+resolvedAt: string | null
+parent: {id: string} | null
+url: string
+```
+
+### `linear comment reply`
+
+Reply to a comment (nested under it)
+
+```
+linear comment reply [options] <commentId> [body]
+```
+
+| Option               | Description                               |
+| -------------------- | ----------------------------------------- |
+| `--body-file <path>` | read reply body from a file ('-' = stdin) |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+parent: string
+issue: string | null
+url: string
+```
+
+### `linear comment resolve`
+
+Resolve a comment thread
+
+```
+linear comment resolve [options] <commentId>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+resolved: boolean
+```
+
+### `linear comment unresolve`
+
+Unresolve a comment thread
+
+```
+linear comment unresolve [options] <commentId>
+```
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+resolved: boolean
+```
+
+### `linear comment update`
+
+Update a comment's body
+
+Aliases: `edit`
+
+```
+linear comment update [options] <commentId> [body]
+```
+
+| Option               | Description                             |
+| -------------------- | --------------------------------------- |
+| `--body-file <path>` | read new body from a file ('-' = stdin) |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+url: string
+```

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

@@ -0,0 +1,17 @@
+# linear completion
+
+> Output a shell completion script (bash|zsh|fish)
+
+_Generated from `linear commands --json`. `linear completion --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 completion`
+
+Output a shell completion script (bash|zsh|fish)
+
+```
+linear completion [options] <shell>
+```
+
+**Output (`--json`)**: none — never prints JSON — always prints a shell script; --json has no effect

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

@@ -0,0 +1,99 @@
+# linear config
+
+> Show the resolved configuration, or write a project config
+
+_Generated from `linear commands --json`. `linear config --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 config`
+
+Show the resolved configuration, or write a project config
+
+```
+linear config [options]
+```
+
+**Output (`--json`)**: a bare object — runs `config show` by default
+
+```text
+apiKey: string
+apiKeySource: string
+credentialWorkspace: string | null
+team: string | null
+workspace: string | null
+sort: string
+origins: {team: {source: string, path?: string, key?: string}, workspace: {source: string, path?: string, key?: string}, sort: {source: string, path?: string, key?: string}}
+userConfigPath: string
+projectConfigPath: string | null
+globalConfigPath: string | null
+```
+
+### `linear config init`
+
+Write a project .linear.toml (at the git root, or here outside a repository)
+
+```
+linear config init [options]
+```
+
+| Option           | Description                                                        |
+| ---------------- | ------------------------------------------------------------------ |
+| `--team <key>`   | default team key (otherwise chosen from a list)                    |
+| `--sort <order>` | default issue-list sort (priority \| manual \| updated \| created) |
+| `--path <file>`  | write this file instead of <git root>/.linear.toml                 |
+| `--force`        | overwrite an existing file                                         |
+
+**Output (`--json`)**: a receipt object
+
+```text
+success: boolean
+path: string
+team: string
+sort?: string
+```
+
+### `linear config set`
+
+Set one project setting (team, workspace, sort) in the project config
+
+```
+linear config set [options] <key> <value>
+```
+
+| Option          | Description                                                  |
+| --------------- | ------------------------------------------------------------ |
+| `--user`        | write the user config (~/.config/linear/config.toml) instead |
+| `--path <file>` | write this file instead of the project config in effect      |
+
+**Output (`--json`)**: a receipt object
+
+```text
+success: boolean
+path: string
+key: string
+value: string
+```
+
+### `linear config show`
+
+Show the resolved configuration and where each value came from (secrets redacted)
+
+```
+linear config show [options]
+```
+
+**Output (`--json`)**: a bare object
+
+```text
+apiKey: string
+apiKeySource: string
+credentialWorkspace: string | null
+team: string | null
+workspace: string | null
+sort: string
+origins: {team: {source: string, path?: string, key?: string}, workspace: {source: string, path?: string, key?: string}, sort: {source: string, path?: string, key?: string}}
+userConfigPath: string
+projectConfigPath: string | null
+globalConfigPath: string | null
+```

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

@@ -0,0 +1,131 @@
+# linear cycle
+
+> Work with cycles
+
+Group alias: `c`
+
+_Generated from `linear commands --json`. `linear cycle --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 cycle`
+
+Work with cycles
+
+Aliases: `c`
+
+```
+linear cycle [options]
+```
+
+### `linear cycle create`
+
+Create a cycle
+
+Aliases: `new`
+
+```
+linear cycle create [options] [team]
+```
+
+| Option           | Description                            |
+| ---------------- | -------------------------------------- |
+| `--start <date>` | start date/time (ISO, e.g. 2026-07-01) |
+| `--end <date>`   | end date/time (ISO, e.g. 2026-07-14)   |
+| `--name <name>`  | custom cycle name                      |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+number: number
+```
+
+### `linear cycle current`
+
+Show the team's currently active cycle
+
+```
+linear cycle current [options] [team]
+```
+
+**Output (`--json`)**: a bare object
+
+```text
+id: string
+number: number
+name: string | null
+description: string | null
+startsAt: string
+endsAt: string
+completedAt: string | null
+progress: number
+team: string | null
+```
+
+### `linear cycle list`
+
+List cycles for a team (defaults to the configured team)
+
+Aliases: `ls`
+
+```
+linear cycle list [options] [team]
+```
+
+**Output (`--json`)**: a bare array of objects
+
+```text
+id: string
+number: number
+name: string | null
+startsAt: string
+endsAt: string
+progress: number
+completedAt: string | null
+```
+
+### `linear cycle update`
+
+Update a cycle (by id, number, or 'current')
+
+Aliases: `edit`
+
+```
+linear cycle update [options] <id>
+```
+
+| Option           | Description           |
+| ---------------- | --------------------- |
+| `--name <name>`  | custom cycle name     |
+| `--start <date>` | start date/time (ISO) |
+| `--end <date>`   | end date/time (ISO)   |
+
+**Output (`--json`)**: a receipt object
+
+```text
+id: string
+number: number
+```
+
+### `linear cycle view`
+
+Show a cycle (by id, number, or 'current')
+
+```
+linear cycle view [options] <id>
+```
+
+**Output (`--json`)**: a bare object
+
+```text
+id: string
+number: number
+name: string | null
+description: string | null
+startsAt: string
+endsAt: string
+completedAt: string | null
+progress: number
+team: string | null
+```