Skip to content

About

Project-grouped completing-read switcher for agent-shell buffers

Resources

Stars

6 stars

Watchers

0 watching

Forks

Latest commit

 

History

29 Commits

Folders and files

Repository files navigation

Agent Shell Consult

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.

agent-shell-consult-annotated-v3
  • 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.

Installation

(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

Saved sessions

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.

Embark actions

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

Development

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-exit

With 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/melpazoid

License

GPL-3.0-or-later. See LICENSE.

About

Project-grouped completing-read switcher for agent-shell buffers

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages