# Install gptline with Homebrew

ChatGPT client with native iTerm2 support. Version 1.0.8 via Homebrew; verified 2026-07-09.

## Install

```sh
sudo av install brew:gptline
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install gptline
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:gptline
- **Package manager:** Homebrew
- **Version:** 1.0.8
- **Source summary:** ChatGPT client with native iTerm2 support
- **Homepage:** <https://github.com/gnachman/gptline>
- **Repository:** <https://github.com/gnachman/gptline>
- **Last updated:** 2026-07-09T10:49:36Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- gptline (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.0.8
## Project history and usage

gptline is George Nachman's Python command-line ChatGPT client, designed around multi-line terminal conversations, searchable history, prompt editing, response regeneration, and iTerm2 marks.

### Project history

The official GitHub repository was created in September 2023, during the first large wave of small ChatGPT terminal clients. The project uses Python packaging and has no GitHub release series; its README and source tree are the primary public record.

Its implementation stores conversations and settings in a local SQLite database while reading an OpenAI API key from `OPENAI_API_KEY` or the legacy `OPENAI_KEY` environment variable.

### Adoption history

The README supports installation from Python packaging with `pip3 install gptline`, while the supplied metadata records a Homebrew formula. This gives the niche client both Python-native and system-package installation paths.

### How it is used

After setting an OpenAI API-key environment variable, users run `gptline` to enter the interactive client. It supports multiple conversations, full-text search, editing and regenerating messages, and iTerm2 marks for moving between messages; `Ctrl+C` exits.

### Why package nerds care

gptline captures the early post-ChatGPT pattern of wrapping a hosted model API in a focused Unix command. Its small Python package, console entry point, local SQLite history, environment-based credentials, and Homebrew availability make it a useful snapshot of that packaging moment.

### Timeline

- 2023: The official GitHub repository is created and gptline is published as a Python terminal client.
- 2023–2024: The client gains conversation search, editing, regeneration, and terminal-oriented interaction.
- 2020s: Homebrew adds a packaged installation route alongside pip.

### Related projects

- OpenAI GPT models provide the remote chat service used by gptline.
- iTerm2 supplies the terminal marks that gptline uses for message navigation.

### Sources

- <https://github.com/gnachman/gptline>
- <https://github.com/gnachman/gptline#readme>
- <https://github.com/gnachman/gptline/blob/main/src/db.py>
- <https://github.com/gnachman/gptline/blob/main/src/main.py>
- source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for gptline. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Combined YAML source

View the package source record on GitHub. [combined/gptline.yml](https://github.com/mxcl/pkgdb/blob/main/combined/gptline.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph