Emacs agent-shell (powered by ACP)
(xenodium.com)201 points by Karrot_Kream 18 hours ago
201 points by Karrot_Kream 18 hours ago
agent-shell: A single native Emacs experience to interact with different AI agents powered by ACP (Agent Client Protocol) https://agentclientprotocol.com
So far, agent-shell can interact with Claude Code, Gemini CLI, Codex, and Goose, but can technically work with any ACP-powered agent.
ps. agent-shell needs more sponsors to become sustainable https://github.com/sponsors/xenodium
Very exciting. I used claude-code-ide, but the fact that it's not using comint-mode is a PITA.
looking forward to trying this!
Can I ask. I haven't dug into the ACP spec. Does it cover the "ide" features too (like Claude code ide. Seems to mostly be telling the agent where your cursor is and diff integration)? Or just the basic stuff?
It's got some of them already like showing and accepting diffs rendered natively. All edits are committed via Emacs itself and on to open buffers if applicable. TAB navigation. Accepting permission has had a fair amount of iteration to smoothen the experience. It's been quite a bit of work to get here. There are obviously more feature to come. Please file feature requests if you find anything missing and of course, sponsor the project if you truly want it to be sustainable and move forward.
Agent shell is what I always wanted. I have been using many of the different Claude code integrations packages and they are really good. But there is always some friction because I need to run it in a terminal emulator. With agent shell it feels so much more integrated and natural.
I am really excited for these improvements, especially reading the env from a file.
I wish that agent-shell-sidebar had some screenshots though so I could see what it actually does.
Xenodium is doing great work for Emacs community. I am currently using `agent-shell` but I don't like the header added on the top of the buffer. I already have all information I want at the bottom. The bottom line you have make it optional so that minimalists can choose to remove it.
> but I don't like the header added on the top of the buffer
Please file a feature request, so we can make the graphical header optional: https://github.com/xenodium/agent-shell/issues
I've used it a few times now. It's a really smooth experience for quite a new package.
It's the same point as LSP, but with AI agents. It's a pain to implement a claude wrapper and a codex wrapper and a gemini wrapper and an aider wrapper and so on for every editor. So the zed people started the effort to standardise the protocol.
So why would one want to use this verses using Claude Code directly?
There's another project called ECA: https://github.com/editor-code-assistant/eca
I think the difference is ECA is a coding agent with a LSP-like protocol for various frontend and editors, which itself supports many models.
Where as agent protocol if I understand lets you use many agents like Gemini CLI, Claude Code, well assuming they support the protocol, using various frontend?
Though I guess other coding agents could also adopt the ECA protocol maybe.
I've tried both and that sounds about right - I had to configure my MCPs for it again and it runs its own server in the background.
For that alone I've preferred agent-shell since you just use the agent's own config. That's already enough of a pain point when each agent has its own config format and location, as well as the differences between project and user level config - would be nice if there was a standard for that at some point too.
Yes, and the ECA project includes an emacs package; I've been using it recently.
I've been diving in to the ECA protocol a bit to debug some emacs issues, and from glancing at the ACP (Agent Client Protocol) documentation, it seems that the ECA and ACP protocols are incredibly similar, and both very well documented. An accident of reinvention.
Hey I know where that’s from!
As an Emacs user, his video was very funny https://youtu.be/urcL86UpqZc?si=Jhqiy1yCXDGHoIoS
I've spent 2 month trying out emacs and I feel like I sort of scratched the surface. It's like the deeper you look the more you realize how much more there is
Code Companion for neovim has supported ACP for a while now
Xenodium is doing amazing things for emacs. If you enjoy this or are generally emacs interested, I’d check out his blog @ https://xenodium.com/
I also purchased my first iOS app upon recommendation from other emacs users - the author’s app, Journelly. A simple portable place to save down links or notes and export out as org files (as one option; apparently markdown is on the way). https://xenodium.com/journelly-for-ios
No affiliation to Xenodium. I’ve just been diving into emacs this year and love seeing his contributions.