doom-agent-shell

A Doom Emacs module for agent-shell — interact with LLM coding agents (Claude, Gemini, Codex, Poolside, and more) from Emacs via the Agent Client Protocol (ACP).

Installation

Clone this repo into your Doom modules directory:

git clone https://github.com/phairoh/doom-agent-shell \
  ~/.config/doom/modules/tools/agent-shell

Enable the module in your init.el under :tools, with at least one provider flag:

:tools
(agent-shell +claude)   ; or +gemini, +codex, +goose, etc.

Run doom sync and restart Emacs.

Flags

The first provider flag sets the default agent. Additional flags only enable doom doctor checks for those providers.

Flag	Provider
+claude	Anthropic Claude
+gemini	Google Gemini CLI
+codex	OpenAI Codex
+goose	Goose (Block)
+mistral	Mistral Vibe
+auggie	Augment Code Auggie
+qwen	Qwen Code
+cursor	Cursor
+github	GitHub Copilot
+opencode	OpenCode
+pool	Poolside pool

Prerequisites

Run doom doctor after installation to verify dependencies are detected.

+claude

• claude CLI (Claude Code) — run it once outside Emacs to log in
• claude-agent-acp:

  npm install -g @agentclientprotocol/claude-agent-acp
      

+gemini

• gemini CLI: https://github.com/google-gemini/gemini-cli

+codex

• codex-acp:

  npm install -g @zed-industries/codex-acp
      

+goose

• goose CLI: https://block.github.io/goose/docs/getting-started/installation

+mistral

• vibe-acp:

  uv tool install mistral-vibe
      

+auggie

• auggie:

  npm install -g @augmentcode/auggie
      

+qwen

• qwen:

  npm install -g @qwen-code/qwen-code@latest
      

+cursor

• cursor-agent-acp:

  npm install -g @blowmage/cursor-agent-acp
      

+github

• copilot CLI: install GitHub Copilot CLI

+opencode

• opencode: https://opencode.ai

+pool

• pool CLI:

  curl -fsSL https://downloads.poolside.ai/pool/install.sh | sh
  pool login
      

Usage

Starting a shell

Keybinding	Description
SPC A a	Open or reuse an agent shell
SPC A n	Start a new agent shell
SPC A t	Toggle agent shell window

Use C-u SPC A a to force the agent picker when a default is set.

Sending content

Keybinding	Description
SPC A s	Send region or error at point to shell
SPC A f	Send current file to shell
SPC A c	Compose a multi-line prompt
SPC A i	Paste clipboard image into shell

Inside the shell

Keybinding	Description
RET	Submit prompt (normal mode)
RET	Insert newline (insert mode)
C-c C-c	Interrupt current agent operation
TAB / S-TAB	Navigate interactive elements
C-<tab>	Cycle session mode
C-c C-o	Switch between shell and viewport

Evil notes

• Normal mode RET submits the prompt.
• Insert mode RET inserts a newline (use normal mode RET to send).
• Diff buffers (*agent-shell-diff*) open in Emacs state so y/n/p/q pass through directly. Press C-z to enter evil if needed.

Configuration

Authentication is handled by each provider’s CLI (run claude login, pool login, etc. outside Emacs first). For API key based providers, set authentication in your private config.el:

;; Claude — API key instead of subscription login
(setq agent-shell-anthropic-authentication
      (agent-shell-anthropic-make-authentication :api-key "your-key-here"))

;; Gemini — API key
(setq agent-shell-google-authentication
      (agent-shell-google-make-authentication :api-key "your-key-here"))

See agent-shell for full authentication documentation for each provider.

Poolside pool

This module includes agent-shell-pool.el, a provider extension for Poolside’s pool CLI. Pool is ACP-compatible and handles authentication via pool login. It is not part of the upstream agent-shell package.