> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ooneex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# issue:pull

> Pull an issue from Linear and save it as a YAML file.

Pull an issue from Linear and save it as a YAML file inside a module's `issues` directory. The issue's identifier is used as the file name, and the `LINEAR_API_KEY` environment variable must be set.

## Usage

```bash theme={null}
ooneex issue:pull [options]
```

## Examples

```bash theme={null}
ooneex issue:pull
```

```bash theme={null}
ooneex issue:pull --id=OON-42 --module=auth
```

## Options

| Option     | Description                             | Default             |
| ---------- | --------------------------------------- | ------------------- |
| `--id`     | Identifier of the Linear issue to pull. | Prompted if omitted |
| `--module` | Module the issue is saved in.           | `shared`            |