# iterm2-version

> Get the iTerm2 version

Latest version **6.0.0** (published 2026-01-05) · MIT license · 0 weekly downloads

## Install

```sh
npm install iterm2-version
pnpm add iterm2-version
yarn add iterm2-version
bun add iterm2-version
```

## Health

**Score 60/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 6.0.0 |
| Published | 2026-01-05 |
| First published | 2016-03-09 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Node | >=20 |
| Dependencies | 3 |
| Unpacked size | 4.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 11 |
| Author | Sindre Sorhus |
| Maintainers | sindresorhus |
| Keywords | iterm2, iterm, terminal, app, version |

## Links

- npm: https://www.npmjs.com/package/iterm2-version
- Repository: https://github.com/sindresorhus/iterm2-version
- Homepage: https://github.com/sindresorhus/iterm2-version#readme
- Issues: https://github.com/sindresorhus/iterm2-version/issues
- Funding: https://github.com/sponsors/sindresorhus
- npm.io page: https://npm.io/package/iterm2-version

## Dependencies (3)

- [plist](https://npm.io/package/plist.md) ^3.1.0
- [app-path](https://npm.io/package/app-path.md) ^4.0.0
- [terminal-query](https://npm.io/package/terminal-query.md) ^0.1.0

## Alternatives

- [localforage](https://npm.io/package/localforage.md) — 6.2M weekly downloads
- [localforage-observable](https://npm.io/package/localforage-observable.md) — 30.8K weekly downloads
- [@y/y](https://npm.io/package/@y/y.md) — 30.1K weekly downloads
- [@metaobjectsdev/render](https://npm.io/package/@metaobjectsdev/render.md) — 3.5K weekly downloads
- [@ledgerhq/coin-algorand](https://npm.io/package/@ledgerhq/coin-algorand.md) — 1.1K weekly downloads

## Recent versions

- 6.0.0 (latest) — 2026-01-05
- 5.0.0 — 2021-05-03
- 4.2.0 — 2019-04-06
- 4.1.0 — 2019-03-20
- 4.0.0 — 2018-12-08
- 3.0.0 — 2018-05-22
- 2.3.0 — 2017-01-13
- 2.2.0 — 2016-04-04
- 2.1.0 — 2016-03-17
- 2.0.0 — 2016-03-17
- 1.0.0 — 2016-03-09

## README

# iterm2-version

> Get the [iTerm2](https://www.iterm2.com) version

Note: The `2` in iTerm2 is [part of the name](https://en.wikipedia.org/wiki/ITerm2) and does not indicate the version.

## Install

```sh
npm install iterm2-version
```

## Usage

```js
import iterm2Version from 'iterm2-version';

console.log(iterm2Version());
//=> '3.5.10'
```

If you're not running in iTerm2, it will return `undefined`.

Works over SSH by querying the terminal via escape sequences when environment variables are not available.

## API

### iterm2Version()

Returns a `string | undefined` with the iTerm2 version.

---
_Source: https://npm.io/package/iterm2-version · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._