> ## 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:push

> Push a local issue YAML to Linear, creating or updating it.

Push a local issue YAML file to Linear. If the issue already exists in Linear it is updated; otherwise it is created, and the local file is renamed to match the assigned identifier.

## Usage

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

## Examples

```bash theme={null}
ooneex issue:push --id=OON-12
```

```bash theme={null}
ooneex issue:push --id=OON-12 --module=billing
```

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

## Options

| Option     | Description                                                                 | Default             |
| ---------- | --------------------------------------------------------------------------- | ------------------- |
| `--id`     | Issue ID, matching the local `<id>.yml` file name.                          | Prompted if omitted |
| `--module` | Module whose `issues` directory holds the file (`modules/<module>/issues`). | `shared`            |

This command reads the `LINEAR_API_KEY` environment variable (required) and the optional `LINEAR_TEAM_ID` environment variable. When creating an issue without `LINEAR_TEAM_ID`, you are prompted to select a target team. Missing states and labels can be created interactively during the push.