chatgpt-shell
Emacs comint shell for ChatGPT, Claude, Gemini, Ollama and more.
Overview
chatgpt-shell gives Emacs a REPL-style buffer for talking to LLMs, plus commands for describing code, proofreading regions and composing prompts. It supports OpenAI, Anthropic, Google, Perplexity, DeepSeek, OpenRouter and Ollama models.
- Shell-style chat buffer
- Model swapping
- Region commands
- Image description
Our verdict
What we like
- Very Emacs-native
- Actively maintained
Watch out for
- Emacs only
Works with these providers
Keys from these providers work in this app. Usage is billed by the provider at its list price.
BYOK Key Safety Score
Key handling in chatgpt-shell
Grade A
Your key is stored on your device and requests go directly to the provider.
- Key storage40/40
Key stays on your device; requests go direct to the provider.
- Auditable code25/25
Open source: anyone can verify how keys are handled.
- Self-hosting8/15
Runs as a local app, but not as a self-hosted service.
- Offline option10/10
Supports local models, so no key is needed at all for private work.
- Provider choice10/10
8 provider options, which lets you pick the provider whose data terms you trust.
Whatever the score, give each app its own key, set a monthly spend limit with your provider, and revoke keys you no longer use. Read the key-safety checklist.
chatgpt-shell FAQ
- Does chatgpt-shell support bring your own key?
- Yes. chatgpt-shell accepts your own API key from OpenAI, Anthropic, Google Gemini, Perplexity, DeepSeek, OpenRouter, Ollama and OpenAI-compatible. Usage is billed by the provider at its API rates.
- Where does chatgpt-shell store my API key?
- On your device. Requests go directly from chatgpt-shell to the provider. Its BYOK Tools Key Safety Score is 93/100.
- Is chatgpt-shell free?
- Open source: Free & open source. API usage is billed separately by your model provider.
- Is chatgpt-shell open source?
- Yes. The source code is at https://github.com/xenodium/chatgpt-shell.
- Can chatgpt-shell run local models?
- Yes. It can connect to local runtimes such as Ollama or LM Studio, so no API key is needed for private or offline use.
- Which platforms does chatgpt-shell support?
- CLI.
Community reviews
No reviews yet.
Alternatives to chatgpt-shell
All coding agents & ides →gptel
Coding Agents & IDEs
Simple, provider-agnostic LLM client for Emacs.
Aider
Coding Agents & IDEs
AI pair programming in your terminal with git-aware edits.
OpenCode
Coding Agents & IDEs
Open-source terminal coding agent that works with any provider.
Goose
Coding Agents & IDEs
Extensible open-source AI agent from Block for coding and beyond.
OpenHands
Coding Agents & IDEs
Open-source autonomous software engineering agent platform.
avante.nvim
Coding Agents & IDEs
Cursor-style AI editing inside Neovim.