# 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
- **Package manager page:** <https://formulae.brew.sh/formula/gptline>
- **Version:** 1.0.8
- **Source summary:** ChatGPT client with native iTerm2 support
- **Homepage:** <https://github.com/gnachman/gptline>
- **Repository:** <https://github.com/gnachman/gptline>
- **License:** GPL-3.0-only
- **Source archive:** <https://files.pythonhosted.org/packages/5b/28/d15a9a5b349c77a051a633e13141151314f352067ec7d516220bd6b20fcf/gptline-1.0.8.tar.gz>
- **Last updated:** 2026-07-09T10:49:36Z
- **Generated:** 2026-08-04T22:13:35+00:00

## Executables

- gptline (cli)
- gptline (alias)

## Dependencies

- certifi
- freetype
- jpeg-turbo
- libraqm
- libtiff
- libyaml
- little-cms2
- pillow
- pydantic
- python@3.14
- webp

## Build dependencies

- pkgconf
- rust

## Uses from macOS

- libxml2
- libxslt

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-08-04
- Package-manager version: 1.0.8
- Package-manager updated: 2026-07-09
- Local data: ok
- Upstream repository: https://github.com/gnachman/gptline
- info: No cached GitHub release or tag data was available.
## 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. Package metadata is still published here so future coverage has a stable package URL.


## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** gptline
- **Version Scheme:** 0
- **Revision:** 22
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Source-control packages](https://pkg.so/source-control-tools/) - Belongs to a source-control command family.
- [MCP tool packages](https://pkg.so/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [AI and agent packages](https://pkg.so/ai-agent-tools/) - Matched AI model, agent, coding-agent, orchestration, or MCP metadata.
- [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [python@3.14](https://pkg.so/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [jpeg-turbo](https://pkg.so/brew/jpeg-turbo/) - Runtime dependency declared by Homebrew.
- [libtiff](https://pkg.so/brew/libtiff/) - Runtime dependency declared by Homebrew.
- [freetype](https://pkg.so/brew/freetype/) - Runtime dependency declared by Homebrew.
- [little-cms2](https://pkg.so/brew/little-cms2/) - Runtime dependency declared by Homebrew.
- [webp](https://pkg.so/brew/webp/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://pkg.so/brew/pkgconf/) - Build dependency declared by Homebrew.
- [rust](https://pkg.so/brew/rust/) - Build dependency declared by Homebrew.
- [chatblade](https://pkg.so/brew/chatblade/) - Shares pkgdb curated category or tags: ai, chatgpt, cli, model-tools, terminal.
- [mods](https://pkg.so/brew/mods/) - Shares pkgdb curated category or tags: ai, cli, model-tools, terminal.
- [tgpt](https://pkg.so/brew/tgpt/) - Shares pkgdb curated category or tags: ai, cli, model-tools, terminal.
- [tenere](https://pkg.so/brew/tenere/) - Shares pkgdb curated category or tags: ai, chatgpt, cli, model-tools.
- [ollama](https://pkg.so/brew/ollama/) - Shares pkgdb curated category or tags: ai, cli, model-tools.
- [llama.cpp](https://pkg.so/brew/llama-cpp/) - Shares pkgdb curated category or tags: ai, cli, model-tools.
- [llmfit](https://pkg.so/brew/llmfit/) - Shares pkgdb curated category or tags: ai, cli, model-tools.
- [cliproxyapi](https://pkg.so/brew/cliproxyapi/) - Shares pkgdb curated category or tags: ai, cli, model-tools.
- [oterm](https://pkg.so/brew/oterm/) - Both packages touch the same language runtime or ecosystem. Shared terms: ai, certifi, cli, client, libyaml.
- [rapid-mlx](https://pkg.so/brew/rapid-mlx/) - Both packages touch the same language runtime or ecosystem. Shared terms: ai, certifi, cli, libyaml, model.

## 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
- package-page enrichment
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- cross-ecosystem install command graph
