agent-shell

Brings your favorite AI agents to Emacs, keeping you at home: familiar buffers and bindings, no terminal emulation. Powered by ACP.

What is agent-shell?

Brings your favorite AI agents to Emacs, keeping you at home: familiar buffers and bindings, no terminal emulation. Powered by ACP.

Overview of agent-shell

What it is

agent-shell is an Emacs package that brings AI agents into the Emacs environment. It allows users to interact with AI agents using familiar Emacs buffers and keybindings, without requiring terminal emulation. The package is powered by the Agent Client Protocol (ACP), an open protocol for communicating with AI coding agents. It is developed by Álvaro Ramírez and is available on MELPA under the GPL-3.0 license.

Key features

  • Works with 24 different AI agents that speak the Agent Client Protocol, including Claude Agent, Gemini CLI, GitHub Copilot, Cursor, and others.
  • Provides a native Emacs interface: agents operate within Emacs buffers, using standard Emacs bindings and workflows.
  • Supports multiple agent backends simultaneously, allowing users to switch between different AI providers.
  • Integrates with a growing ecosystem of community packages for extended functionality, such as skills, notifications, bookmarks, and Org-mode transcripts.
  • Includes video tutorials and blog posts demonstrating features and usage patterns.

Use cases

agent-shell is designed for developers who want to use AI coding agents directly within Emacs. Use cases include: getting code suggestions and completions from multiple AI providers; running agent-assisted code reviews; prototyping applications with AI help; managing multiple agent sessions for different projects; and integrating AI assistance into existing Emacs workflows for editing, debugging, and refactoring.

Getting started

See the repository README for installation and configuration instructions. The package is available on MELPA and can be installed via M-x package-install RET agent-shell RET. After installation, refer to the README for setup commands and agent configuration.

License and pricing

The package is open source under the GPL-3.0 license. The README includes a request for funding via GitHub Sponsors to support development and maintenance, but the software itself is free to use.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/xenodiumagent-shell.svg)](https://yunodb.com/tools/xenodiumagent-shell?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/xenodiumagent-shell?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/xenodiumagent-shell.svg" alt="Featured on YunoDB" height="20"></a>