A Consult interface for managing agent-shell buffers.
Acts like an enhanced version agent-shell-switch-buffer, with session details,
live previews, and Embark actions.
- See each session's project, state, idle time, queued message count, and title.
- Search by buffer name, project, or session title.
- Filter by current project or state, including drafts.
- Preview sessions as you move through the list.
- Browse Active, Inactive, and Saved sessions in separate groups.
- Resume saved sessions across configured agents and projects.
- Use Embark to interrupt, fork, change models, and more.
With agent-shell-attention, a ● beside the state marks unread output. Selecting a session clears the indicator; previewing leaves it unread. Pending permissions remain.
(use-package agent-shell-consult
:ensure (:host github :repo "Gleek/agent-shell-consult")
:after agent-shell
:bind (("C-c q b" . agent-shell-consult)
(:map agent-shell-mode-map
("C-z b" . agent-shell-consult))))- Dependencies: Emacs 29.1+, Agent Shell 0.83.4+, acp.el 0.18.1+, and Consult 3.0+.
- Optional (but recommended) dependencies: Embark, agent-shell-attention
Enable saved sessions for your agents:
(setq agent-shell-consult-session-agents
'(agent-shell-anthropic-make-claude-code-config
agent-shell-openai-make-codex-config))The default is nil (existing buffers only). Config alists are also accepted.
Existing buffers offer:
| Key | Action |
|---|---|
RET |
Switch to the agent shell |
f |
Fork into a separate session |
k |
Kill the agent-shell buffer |
K |
Stop the agent process |
r |
Rename the buffer |
R |
Reload the current session |
n |
New shell in the same project |
m |
Set the session mode |
l |
Set the model |
i |
Interrupt the current request |
t |
Open the session transcript |
p |
Copy the transcript path |
L |
Toggle ACP logging |
T |
View ACP traffic |
Saved sessions offer:
| Key | Action |
|---|---|
RET |
Resume the session |
f |
Fork into a separate session |
n |
New shell in the same project |
w |
Copy the session ID |
d |
Open the working directory in Dired |
c |
Copy a native CLI resume command |
t |
View an existing Agent Shell transcript |
p |
Copy the transcript path |
Install dependencies in a separate temporary package directory and run the tests:
emacs -Q --batch -L . -l tests/setup.el \
-l tests/agent-shell-consult-test.el -f ert-run-tests-batch-and-exitWith a checkout of melpazoid and Docker:
LOCAL_REPO="$PWD" \
RECIPE='(agent-shell-consult :fetcher github :repo "Gleek/agent-shell-consult")' \
WARN_IS_ERROR=true make -C /path/to/melpazoidGPL-3.0-or-later. See LICENSE.