macOS
Homebrewverified · 100%
brew install gptmelocal Homebrew formula metadata
brew / rank 3663
Install gptme with Homebrew
AI assistant in your terminal. Version 0.32.1 via Homebrew; verified 2026-07-18.
install
Additional install commands
overview
Package summary
AI assistant in your terminal
Project links
Commands and aliases
- gptme
- gptme-acp
- gptme-agent
- gptme-attest
- gptme-auth
- gptme-checkpoint
- gptme-doctor
- gptme-dspy
- gptme-eval
- gptme-eval-swebench
- gptme-eval-tbench
- gptme-eval-trends
- gptme-init
- gptme-mcp-server
- gptme-onboard
- gptme-resume
- gptme-server
- gptme-status
- gptme-tui
- gptme-util
- gptme-wut
history
Project history and usage
gptme is a terminal AI assistant and agent framework that gives language models access to local tools such as shell commands, file editing, browser/web operations, and project context.
Project history
The official repository describes gptme as an agent in the terminal, equipped with local tools to write code, use the terminal, and browse the web. The project site positions it as a small, simple assistant rather than a platform trying to cover every workflow.
The documentation and release pages show a project organized around CLI usage, tools, prompts, configuration files, local logs, project workspaces, plugins, RAG/context features, and autonomous agent patterns.
The release documentation records a long sequence of tagged versions. By v0.8.1, release notes already included auto-continue/recovery after tool execution, project-context work, web UI conversation creation, command-output capture, and integration-test improvements.
Adoption history
gptme belongs to the package-manager wave of LLM developer tools that moved from simple chat wrappers toward local agent workflows. Its Homebrew package exposes several executables, reflecting a broader tool suite rather than a single chat binary.
The project's adoption signal is strongest among developers who want a terminal-native assistant with reproducible logs, configurable model/provider settings, and explicit local tool use.
How it is used
Users run `gptme` as an interactive terminal assistant and configure user preferences in `~/.config/gptme/config.toml`. Secrets and local overrides can live in `~/.config/gptme/config.local.toml`, and project-specific behavior can be configured with `gptme.toml` in a workspace root.
The docs cover CLI subcommands, prompt/context handling, tool execution, project config, MCP server configuration, plugin settings, chat logs, and agent-oriented workflows.
The package also installs helper commands such as `gptme-server`, `gptme-util`, and evaluation or integration utilities, making it more of a local developer-assistant toolkit than a plain chat command.
Why package nerds care
gptme is significant for package nerds because it packages an AI agent as a normal terminal tool with config files, subcommands, logs, plugins, and optional integrations instead of hiding everything behind a hosted UI.
Its config split between committed preferences and local secret overrides is also packaging-relevant: it gives dotfile users a predictable Unix-style setup while leaving room for provider keys and MCP credentials.
Timeline
- 2020s: gptme develops as a terminal AI assistant and local agent toolkit.
- 2024: Public project discussion includes config.toml documentation needs.
- 2026: Official documentation lists release pages back through early v0.x versions.
- 2026: Release notes for v0.8.1 document agent/tooling features such as auto-continue after code execution and project-context work.
Related projects
- OpenAI, Anthropic, llama.cpp, OpenRouter, MCP servers, RAG tools, and local shell/file/browser tooling are all part of gptme's documented integration space.
- gptme-contrib provides related scripts, plugins, lessons, and integration examples around the core project.
Sources
security posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for gptme. Nucleus package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
~/.config/gptme/config.toml./gptme.toml
Credential files
Credential-bearing paths to review before unattended agent runs.
- Unix
~/.config/gptme/config.local.toml~/.config/gptme/config.toml
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
gptme | executable | indexed executable | Discovered from the local executable index. |
gptme-acp | executable | indexed executable | Discovered from the local executable index. |
gptme-agent | executable | indexed executable | Discovered from the local executable index. |
gptme-attest | executable | indexed executable | Discovered from the local executable index. |
gptme-auth | executable | indexed executable | Discovered from the local executable index. |
gptme-checkpoint | executable | indexed executable | Discovered from the local executable index. |
gptme-doctor | executable | indexed executable | Discovered from the local executable index. |
gptme-dspy | executable | indexed executable | Discovered from the local executable index. |
gptme-eval | executable | indexed executable | Discovered from the local executable index. |
gptme-eval-swebench | executable | indexed executable | Discovered from the local executable index. |
gptme-eval-tbench | executable | indexed executable | Discovered from the local executable index. |
gptme-eval-trends | executable | indexed executable | Discovered from the local executable index. |
gptme-init | executable | indexed executable | Discovered from the local executable index. |
gptme-mcp-server | executable | indexed executable | Discovered from the local executable index. |
gptme-onboard | executable | indexed executable | Discovered from the local executable index. |
gptme-resume | executable | indexed executable | Discovered from the local executable index. |
gptme-server | executable | indexed executable | Discovered from the local executable index. |
gptme-status | executable | indexed executable | Discovered from the local executable index. |
gptme-tui | executable | indexed executable | Discovered from the local executable index. |
gptme-util | executable | indexed executable | Discovered from the local executable index. |
gptme-wut | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version0.32.1
manager updated2026-07-18
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:gptme |
|---|---|
| Version | 0.32.1 |
| Package manager | Homebrew |
| Homepage | https://gptme.org/docs/ |
| Repository | https://github.com/ErikBjare/gptme |
| Last updated | 2026-07-18T15:18:41Z |
| Pulse | updated |
| Bottle | not recorded |
| Service | none declared |
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- pkg.so package database
- pkgdb category and tag curation