# @google-automations/issue-utils

> Utilities for github issues

Latest version **5.2.1** (published 2026-09-16) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @google-automations/issue-utils
pnpm add @google-automations/issue-utils
yarn add @google-automations/issue-utils
bun add @google-automations/issue-utils
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 5.2.1 |
| Published | 2026-09-16 |
| First published | 2022-07-08 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >= 22 |
| Dependencies | 1 |
| Unpacked size | 29.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 748 |
| Author | Jeff Ching |
| Maintainers | google-wombot |
| Keywords | github issues, Probot |

## Links

- npm: https://www.npmjs.com/package/@google-automations/issue-utils
- Repository: https://github.com/googleapis/repo-automation-bots
- Issues: https://github.com/googleapis/repo-automation-bots/issues
- npm.io page: https://npm.io/package/@google-automations/issue-utils

## Dependencies (1)

- [gcf-utils](https://npm.io/package/gcf-utils.md) ^17.2.0

## Recent versions

- 5.2.1 (latest) — 2026-09-16
- 5.2.0 — 2026-07-24
- 5.1.1 — 2026-04-01
- 5.1.0 — 2025-10-28
- 5.0.1 — 2025-10-07
- 5.0.0 — 2025-03-12
- 4.0.0 — 2024-09-06
- 3.0.0 — 2023-09-18
- 2.2.0 — 2023-09-18
- 2.1.2 — 2023-01-10
- 2.1.1 — 2023-01-04
- 2.1.0 — 2022-09-20
- 2.0.0 — 2022-08-15
- 1.0.0 — 2022-07-08

## README

# Utility for Managing GitHub issues

This is a small utility for managing GitHub issues.

## Usage

### Install

```bash
npm i @google-automations/issue-utils
```

### Usage

`addOrUpdateIssue` will automatically open or update a GitHub issue.
It searches for the issue by title and will update it if necessary.

Example usage:

```ts
import {addOrUpdateIssue} from '@google-automations/issue-utils';

const issue = await addOrUpdateIssue(
  octokit,
  'testOwner',
  'testRepo',
  'This is the title of the issue',
  'This is the body of the issue',
  ['some-label', 'another-label']
);
console.log('Issue: ', issue.number);
```

---
_Source: https://npm.io/package/@google-automations/issue-utils · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._