Interact with LLM agents in Emacs with Agent-Shell, built for founders, with 1.6k+ GitHub stars.
1,602 stars201 forksEmacs LispQuality 8/10Updated 7/23/2026100% free ยท open source
What it does
Agent-Shell allows you to interact with Large Language Model (LLM) agents directly within Emacs, providing a native buffer for querying and receiving responses from these models.
Install / run
To install Agent-Shell, first ensure you have Emacs and then run the command `git clone https://github.com/xenodium/agent-shell.git` followed by opening Emacs and running `M-x package-install-file` and then loading the package with `M-x load-file` and selecting the `agent-shell.el` file.
When to use it
โขWhen you need to integrate LLM capabilities into your Emacs workflow for content generation or research.
โขAs a founder, when you want to quickly prototype or test LLM-powered features without leaving your development environment.
โขFor automating tasks or generating content that can leverage the strengths of LLMs, such as text summarization or question answering.
Quick start
1Open Emacs and load the `agent-shell` package by running `M-x load-file` and selecting the `agent-shell.el` file.
2Configure your Agent-Shell by customizing the `agent-shell-acp-url` and `agent-shell-api-key` variables, accessible via `M-x customize-group` and then selecting `agent-shell`.
3Start the Agent-Shell server by running `M-x agent-shell-server-start`.
4Connect to an LLM agent by running `M-x agent-shell-connect` and following the prompts.
5Query the LLM agent using the `agent-shell-query` command, and view responses in the Agent-Shell buffer.
Ready-to-paste prompt
To query an LLM agent about 'how AI can aid in startup marketing', run the command `M-x agent-shell-query` and input the prompt 'What are some innovative ways AI can help with marketing in startups?'
Heads up: Before using Agent-Shell, ensure you have an API key for the LLM service you wish to use, as this is required for configuration and authentication within the `agent-shell` package.
Saves to your device
Topics
ai
claude
claude-code
codex
emacs
emacs-lisp
gemini
goose
llm
openai
What's inside โ free to inspect
No purchase needed
Read the entire source before you build โ unlike paid marketplaces that hide it behind a buy button.