# xenodium/agent-shell

A native Emacs buffer to interact with LLM agents powered by ACP

Repository: https://github.com/xenodium/agent-shell
Canonical: https://ross.abutalabs.com/products/agent-shell
Homepage: https://xenodium.com
Language: Emacs Lisp
License: GPL-3.0
License Family: copyleft
Topics: ai, claude, claude-code, codex, emacs, emacs-lisp, gemini, goose, llm, openai
Last push: 2026-08-23T19:39:04+00:00

## Health v2 (maintenance only)
Score: 62/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 35, longevity 25
- inputs: {"age_days": 358, "days_push": 10, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_readme
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1776, forks 223 (observed 2026-08-28T04:05:34.415162+00:00)

## What it is
agent-shell is an Emacs Lisp package that provides a native Emacs buffer interface for interacting with LLM coding agents (Claude Code, OpenAI Codex, Gemini, Goose, etc.) via the Agent Client Protocol (ACP). It brings agent-driven AI assistance directly into the Emacs editing environment.

## Use cases
- chat with claude code from emacs
- run openai codex agent inside an emacs buffer
- interact with gemini cli agent in emacs
- use goose ai agent from emacs
- emacs interface for llm coding agents via acp
- delegate coding tasks to an ai agent without leaving emacs

## When to choose
- you live in Emacs and want AI agent assistance in your editor
- you want a native Emacs UI for ACP-compatible agents like Claude Code or Codex
- you prefer elisp-extensible, keyboard-driven agent interaction over standalone AI apps

## When to avoid
- you don't use Emacs
- you need a GUI or web-based AI chat client
- your agent does not support the Agent Client Protocol

## Facets
- artifact type: plugin
- maturity: active
- function: chatbot, chat-interface, agent-framework, llm-inference
- domain: large-language-models, developer-tools, text-editors
- platform: editor-plugin, cross-platform
- tags: emacs-lisp, acp, claude-code, codex, gemini, goose, melpa, llm-agents, ai-agents, emacs

## Member repositories
- xenodium/agent-shell (main) score 62

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:34.415162+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:25:19.107963+00:00, confidence not recorded.
  - homepage: https://xenodium.com (fetched 2026-08-29T11:03:53.000631+00:00, sha 742ed7dbcf13)
  - site_page: https://xenodium.com/generating-elisp-org-docs (fetched 2026-08-29T11:03:53.012944+00:00, sha f1777e497590)
  - site_page: https://xenodium.com/emacs-fuzzy-search-apples-online-docs (fetched 2026-08-29T11:03:53.014708+00:00, sha d2d4aec17424)
  - site_page: https://xenodium.com/installing-ludget-ledger-visualization (fetched 2026-08-29T11:03:53.016262+00:00, sha 04ddddf09692)
  - site_page: https://xenodium.com/installing-inkscape-with-homebrew (fetched 2026-08-29T11:03:53.017762+00:00, sha f0d630651965)
  - site_page: https://xenodium.com/homebrew-install-from-cache (fetched 2026-08-29T11:03:53.019234+00:00, sha f1862426a5c2)
  - site_page: https://xenodium.com/installing-gnuplot-on-macos (fetched 2026-08-29T11:03:53.020652+00:00, sha fbc558e952a5)
  - site_page: https://xenodium.com/installing-emacs-spaceline (fetched 2026-08-29T11:03:53.022340+00:00, sha 4b63acd18a05)
  - site_page: https://xenodium.com/native-emacsmacos-ux-integrations-via-swift-modules (fetched 2026-08-29T11:03:53.010962+00:00, sha ed3f6d84bf7c)
- Data as of 2026-08-30T08:39:29.467469+00:00.