Agent Shell

https://github.com/xenodium/agent-shell
Admin
A shell environment or command-line interface designed for interacting with or managing agents.
Tokens:69,696
Snippets:560
Trust Score:8.8
License:GPL-3.0
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install opencode (bash)

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Installs the opencode coding agent via the official install script. Requires curl and bash.

```bash
curl -fsSL https://opencode.ai/install | bash
```

--------------------------------

### Install ollama and pull Qwen2.5:7b (bash)

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Installs ollama and pulls the local Qwen2.5:7b model. Requires sudo permission to initialize ollama.service. If behind a network proxy, ollama pull will timeout; add proxy settings inside /etc/systemd/system/ollama.service.

```bash
curl -fsSL https://ollama.com/install.sh | sh
ollama pull qwen2.5:7b
```

--------------------------------

### Install Mistral Vibe via uv tool

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Installs Mistral Vibe using uv tool. See https://github.com/mistralai/mistral-vibe for details.

```bash
uv tool install mistral-vibe
```

--------------------------------

### Install Qwen Code globally via npm

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Installs the latest Qwen Code package globally. See https://github.com/QwenLM/qwen-code for details.

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

--------------------------------

### Install Oh My Pi globally via bun

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Installs the Oh My Pi coding agent globally using bun. See https://github.com/can1357/oh-my-pi for details.

```bash
bun install -g @oh-my-pi/pi-coding-agent
```

--------------------------------

### Install Auggie CLI globally via npm

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Installs the Auggie CLI globally. See https://docs.augmentcode.com/cli/overview for details.

```bash
npm install -g @augmentcode/auggie
```

--------------------------------

### Install Pi ACP adapter globally via npm

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Installs the pi-acp adapter globally. See https://github.com/svkozak/pi-acp for details.

```bash
npm install -g pi-acp
```

--------------------------------

### Install Kimi Code CLI via curl

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Installs the Kimi Code CLI using a curl pipe to bash. See https://www.kimi.com/code for details.

```bash
curl -L code.kimi.com/install.sh | bash
```

--------------------------------

### Start agent-shell programmatically with agent-shell-start

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-core.md

Shows how to call `agent-shell-start` with a configuration. The `config` parameter is required and is an agent configuration alist. Returns the new shell buffer.

```elisp
(agent-shell-start
 :config (agent-shell-anthropic-make-claude-code-config))
```

--------------------------------

### Subscribe and unsubscribe example

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-events.md

Shows how to subscribe to an event and then unsubscribe using the returned token. The subscription is created with agent-shell-subscribe-to, and the token is passed to agent-shell-unsubscribe.

```elisp
(let ((token (agent-shell-subscribe-to
              :shell-buffer shell-buffer
              :event 'file-write
              :on-event (lambda (event)
                          (message "wrote %s" (map-elt (map-elt event :data) :path))))))
  (agent-shell-unsubscribe :subscription token))
```

--------------------------------

### Compose a prompt programmatically into a new viewport

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-viewport.md

Demonstrates how to start a shell with a specific configuration, insert text, and switch to the viewport buffer.

```elisp
(let ((shell (agent-shell-start :config (agent-shell-google-make-gemini-config)))
  (agent-shell-insert :text "Design the data model" :shell-buffer shell)
  (agent-shell-other-buffer))   ; from the shell, opens the viewport
```

--------------------------------

### agent-shell-start

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-core.md

Programmatic entry point to start a new agent shell with a specified configuration, optionally resuming an existing session.

```APIDOC
## agent-shell-start

### Description
Programmatically start a new agent shell with the given configuration. Returns the new shell buffer.

### Signature
```elisp
(cl-defun agent-shell-start (&key config session-id outgoing-request-decorator)
```

### Parameters
- **config** (agent configuration alist) - Required - Configuration passed to `agent-shell--start`, displayed, and stored in state.
- **session-id** (string) - Optional - Resume an existing ACP session by id.
- **outgoing-request-decorator** (function) - Optional - Passed through to `acp-make-client`; takes precedence over `agent-shell-outgoing-request-decorator`.

### Returns
- The new shell buffer.

### Example
```elisp
(agent-shell-start
 :config (agent-shell-anthropic-make-claude-code-config))
```
```

--------------------------------

### agent-shell-new-downloads-shell

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-core.md

Starts a new agent shell in the user's Downloads directory.

```APIDOC
## agent-shell-new-downloads-shell

### Description
Start a shell in `~/Downloads`.

### Signature
```elisp
(cl-defun agent-shell-new-downloads-shell (&key config no-display)
```

### Parameters
- **config** - Optional - Agent configuration.
- **no-display** - Optional - If non-nil, do not display the shell buffer.
```

--------------------------------

### Install Kiro CLI via curl

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Installs the Kiro CLI using a curl pipe to bash. See https://kiro.dev/docs/cli/acp/ for details.

```bash
curl -fsSL https://cli.kiro.dev/install | bash
```

--------------------------------

### Example: Claude Code agent configuration

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-make-agent-config.md

Shows how to build a complete agent configuration for Claude Code using agent-shell-make-agent-config. This example is taken from agent-shell-anthropic-make-claude-code-config (agent-shell-anthropic.el:134). It sets the identifier, mode-line-name, buffer-name, shell-prompt, shell-prompt-regexp, icon-name, welcome-function, client-maker, default-model-id, default-session-mode-id, session-meta, and install-instructions.

```elisp
(agent-shell-make-agent-config
 :identifier 'claude-code
 :mode-line-name "Claude"
 :buffer-name "Claude"
 :shell-prompt "Claude> "
 :shell-prompt-regexp "Claude> "
 :icon-name "claudecode.png"
 :welcome-function #'agent-shell-anthropic--claude-code-welcome-message
 :client-maker (lambda (buffer)
                 (agent-shell-anthropic-make-claude-client :buffer buffer))
 :default-model-id (lambda () agent-shell-anthropic-default-model-id)
 :default-session-mode-id (lambda () agent-shell-anthropic-default-session-mode-id)
 :session-meta '((claudeCode . ((options . ((thinking . ((type . "adaptive")
                                                         (display . "summarized"))))))))
 :install-instructions "See https://github.com/agentclientprotocol/claude-agent-acp for installation.")

```

--------------------------------

### Example session/push response alists

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-experimental.md

Examples of success and error response alists generated by agent-shell-experimental--make-session-push-response.

```elisp
((:request-id . 3) (:result . nil))                     ; success
((:request-id . 3) (:error . ((:code . -32000) (:message . "Busy"))))
```

--------------------------------

### Install Factory Droid via curl

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Installs Factory Droid using a curl pipe to sh. See https://factory.ai for details.

```bash
curl -fsSL https://app.factory.ai/cli | sh
```

--------------------------------

### agent-shell-new-shell

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-core.md

Starts a new agent shell, always prompting for an agent configuration.

```APIDOC
## agent-shell-new-shell

### Description
Always prompts for an agent (`agent-shell '(4)`).

### Signature
```elisp
(defun agent-shell-new-shell ()
```
```

--------------------------------

### agent-shell-diff usage example

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-diff.md

Displays a single diff and executes cleanup callbacks when the buffer is dismissed.

```elisp
;; display one diff and run clean-up when dismissed
(agent-shell-diff
 :diffs (list (list (cons :old old-text)
                    (cons :new new-text)
                    (cons :file "/tmp/example.txt")))
 :on-accept (lambda () (message "accepting..."))
 :on-reject (lambda () (message "rejecting..."))
 :on-exit   (lambda () (message "diff closed")))
```

--------------------------------

### Programmatic send with agent-shell-insert

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-core.md

Programmatic example of calling agent-shell-insert with a text prompt, submit flag, and a shell buffer obtained via agent-shell-shell-buffer with :no-create and :no-error options.

```elisp
(agent-shell-insert
 :text "Summarize the changes in the last commit"
 :submit t
 :shell-buffer (agent-shell-shell-buffer :no-create t :no-error t))
```

--------------------------------

### _session/steering request structure

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/endpoints.md

Example of the custom _session/steering request built by agent-shell-experimental--make-session-steering-request.

```json
{
  "method": "_session/steering",
  "params": {
    "sessionId": "sess-1",
    "prompt": [{"type": "text", "text": "just the filenames"}],
    "_meta": {"steering": {"idleBehavior": "promptRequired"}}
  }
}
```

--------------------------------

### Example steering request

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-prompt-queue.md

Shows the structure of a steering request returned by make-session-steering-request. The prompt is a vector of ACP content blocks.

```elisp
((:method . "_session/steering")
 (:params . ((sessionId . "sess-1")
             (prompt . [((type . "text") (text . "just the filenames"))])
             (_meta . ((steering . ((idleBehavior . "promptRequired"))))))))
```

--------------------------------

### agent-shell-new-temp-shell

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-core.md

Starts a new agent shell in a temporary directory, which is cleaned up when the buffer is killed.

```APIDOC
## agent-shell-new-temp-shell

### Description
Start a shell in a temporary directory. The temp directory is deleted when the shell buffer is killed (`agent-shell--pending-directory-cleanup`).

### Signature
```elisp
(cl-defun agent-shell-new-temp-shell (&key config no-display)
```

### Parameters
- **config** - Optional - Agent configuration.
- **no-display** - Optional - If non-nil, do not display the shell buffer.
```

--------------------------------

### Customize key bindings for send and interrupt

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Example configuration to set C-c C-c for submitting and C-c C-k for interrupting agent operations.

```emacs-lisp
(use-package agent-shell
  :bind (:map agent-shell-mode-map
              ("RET" . newline)
              ("C-c C-c" . shell-maker-submit)
              ("C-c C-k" . agent-shell-interrupt)))
```

--------------------------------

### Bootstrap Antigravity ACP server (emacs-lisp)

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Downloads and installs the latest Antigravity ACP server binary for the current platform. Uses the registry at https://raw.githubusercontent.com/agentclientprotocol/registry/main/antigravity-acp/agent.json and requires 'unzip'. Sets executable permissions and updates agent-shell-antigravity-acp-command.

```emacs-lisp
(defun agent-shell-antigravity-bootstrap (&optional force)
  "Download and install the latest Antigravity ACP server binary."
  (interactive "P")
  (let* ((arch (pcase (car (split-string system-configuration "-"))
                   ((or "x86_64" "amd64") "x86_64")
                   ((or "aarch64" "arm64") "aarch64")
                   (a a)))
           (os (pcase system-type ('darwin "darwin") ('windows-nt "windows") (_ "linux")))
           (platform (format "%s-%s" os arch))
           (install-dir (agent-shell-cache-dir "antigravity" platform))
           (bin-name (file-name-nondirectory (car agent-shell-antigravity-acp-command)))
           (bin-path (expand-file-name bin-name install-dir)))
      (unless (and (not force) (file-executable-p bin-path))
        (message "Antigravity: bootstrapping server for %s..." platform)
        (make-directory install-dir t)
        (let* ((reg-url "https://raw.githubusercontent.com/agentclientprotocol/registry/main/antigravity-acp/agent.json")
               (reg (with-temp-buffer
                      (url-insert-file-contents reg-url)
                      (json-parse-buffer :object-type 'alist)))
               (archive-url (map-nested-elt reg `(distribution binary ,(intern platform) archive)))
               (zip (expand-file-name "server.zip" install-dir)))
          (url-copy-file archive-url zip t)
          (call-process "unzip" nil nil nil "-o" "-q" zip "-d" install-dir)
          (delete-file zip)
          (set-file-modes bin-path #o755)))
      (setq agent-shell-antigravity-acp-command
            (cons bin-path (cdr agent-shell-antigravity-acp-command)))
      (message "Antigravity: using ACP server at %s" bin-path)
      bin-path))
```

--------------------------------

### Run CodeBuddy in ACP mode

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Starts CodeBuddy with ACP mode enabled using the --acp flag. Requires the CodeBuddy CLI installed.

```bash
codebuddy --acp
```

--------------------------------

### Filter example: only install agents whose executable exists

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-make-agent-config.md

Sets agent-shell-agent-configs to a lambda that filters the default makers, keeping only those whose executable is found. Uses seq-filter and executable-find.

```elisp
(setq agent-shell-agent-configs
      (lambda ()
        (seq-filter
         (lambda (maker)
           (when-let* ((config (funcall maker))
                       (client-maker (map-elt config :client-maker))
                       (client (ignore-errors (funcall client-maker (current-buffer))))
                       (command (map-elt client :command)))
             (executable-find command)))
         (agent-shell-default-agent-config-makers))))
```

--------------------------------

### Install agent-shell with use-package (emacs-lisp)

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Installs agent-shell and its dependencies via use-package. The :ensure-system-package directive installs claude and claude-agent-acp using the specified commands.

```emacs-lisp
(use-package agent-shell
    :ensure t
    :ensure-system-package
    ;; Add agent installation configs here
    ((claude . "brew install claude-code")
     (claude-agent-acp . "npm install -g @agentclientprotocol/claude-agent-acp")))
```

--------------------------------

### Programmatic integration using agent-shell-shell-buffer and agent-shell-insert

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-core.md

Example for packages integrating programmatically. Resolves a shell buffer without error or creation, then inserts text "hello" into it. Useful for programmatic interaction with the agent shell.

```elisp
;; packages integrating programmatically
(let ((shell (agent-shell-shell-buffer :no-error t :no-create t)))
  (when shell
    (agent-shell-insert :text "hello" :shell-buffer shell)))
```

--------------------------------

### Configure opencode.json for agent-shell

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Example configuration file at ~/.config/opencode/opencode.json that sets permissions for edit, bash, and webfetch, and configures an Ollama provider with the qwen2.5:7b model. The provider uses the @ai-sdk/openai-compatible npm package and a base URL of http://localhost:11434/v1.

```js
{
    "$schema": "https://opencode.ai/config.json",
    "permission": {
	"edit": "ask",
	"bash": "ask",
	"webfetch": "allow"
    },
   "provider": {
       "ollama": {
	   "name": "qwen2.5:7b",
	   "npm": "@ai-sdk/openai-compatible",
           "options": {
               "baseURL": "http://localhost:11434/v1"
           },
           "models": {
       	       "qwen2.5:7b": { "name": "Qwen2.5 7b" }
           }
       }
   }
}
```

--------------------------------

### Example client maker pattern (agent-shell-anthropic-make-claude-client)

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-agent-integrations.md

Shows the common client maker pattern used across agent integration files. It requires a :buffer argument and passes the command through agent-shell--make-acp-client, which applies agent-shell-command-prefix.

```elisp
;; e.g. agent-shell-anthropic.el:169
(cl-defun agent-shell-anthropic-make-claude-client (&key buffer)
  ;; (unless buffer (error "Missing required argument: :buffer"))
  (agent-shell--make-acp-client :command (car agent-shell-anthropic-claude-acp-command)
                                :command-params (cdr agent-shell-anthropic-claude-acp-command)
                                :environment-variables (append ... agent-shell-*-environment)
                                :context-buffer buffer))
```

--------------------------------

### Custom status labels usage example

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-utilities.md

Example of setting a custom status kind label function that formats the status and kind into a bracket string.

```elisp
(setq agent-shell-status-kind-label-function
      (lambda (status kind)
        (format "[%s %s]" (or status "?") (or kind "?"))))
```

--------------------------------

### Install Claude Agent ACP globally via npm

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Installs the Claude Agent ACP binary globally. The -g flag is required so the binary is available in your PATH. Verify with 'which claude-agent-acp'.

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

--------------------------------

### Bind agent-shell to a key and force new session with prefix

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-core.md

Shows how to bind the `agent-shell` command to a key and how to force a new session using a prefix argument. The `C-u` prefix forces a new shell, and `C-u C-u` prompts to pick an existing shell.

```elisp
(global-set-key (kbd "C-c a") #'agent-shell)
;; C-u M-x agent-shell starts a brand-new session instead of reusing one
(agent-shell '(4))
```

--------------------------------

### Configure Auggie authentication with login

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Sets up agent-shell-auggie-authentication using login-based authentication, the default.

```Emacs Lisp
(setq agent-shell-auggie-authentication
      (agent-shell-make-auggie-authentication :login t))
```

--------------------------------

### Heartbeat functions signatures

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-utilities.md

Signatures for the heartbeat module's main functions. agent-shell-heartbeat-make requires :on-heartbeat and returns an alist; start fires the callback with status 'started then ticks at beats-per-second with status 'busy; stop ends with status 'ended.

```elisp
(cl-defun agent-shell-heartbeat-make (&key start (beats-per-second 10) on-heartbeat)  ; line 37
(cl-defun agent-shell-heartbeat-start (&key heartbeat)                                 ; line 70
(cl-defun agent-shell-heartbeat-stop (&key heartbeat)                                  ; line 95
```

--------------------------------

### Configure Qwen authentication with OAuth login

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Sets up agent-shell-qwen-authentication using OAuth login-based authentication. Use this for standard Qwen authentication.

```Emacs Lisp
(setq agent-shell-qwen-authentication
      (agent-shell-qwen-make-authentication :login t))
```

--------------------------------

### Customize RET binding

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Example configuration to remap the RET key behavior within agent-shell-mode.

```emacs-lisp
(use-package agent-shell
  :bind (:map agent-shell-mode-map
              ("RET" . newline)
              ("M-RET" . shell-maker-submit)))
```

--------------------------------

### List test files

Source: https://github.com/xenodium/agent-shell/blob/main/CONTRIBUTING.org

Lists the test files under the tests directory. The output shows three test files: agent-shell-anthropic-tests.el, agent-shell-openai-tests.el, and agent-shell-tests.el.

```bash
ls tests/*tests.el
```

```text
| tests/agent-shell-anthropic-tests.el |
| tests/agent-shell-openai-tests.el    |
| tests/agent-shell-tests.el           |
```

--------------------------------

### agent-shell-insert function signature

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-core.md

Definition signature for the agent-shell-insert command. It inserts text at point-max of the shell buffer (or viewport compose buffer when agent-shell-prefer-viewport-interaction is non-nil). Returns an alist ((:buffer . BUFFER) (:start . START) (:end . END)) or nil; raises user-error "Busy, try later" if busy, and waits for the prompt-ready event if the session is not ready.

```elisp
(cl-defun agent-shell-insert (&key text submit no-focus shell-buffer)  ; agent-shell.el:9824
```

--------------------------------

### Configure Qwen authentication for OpenAI-compatible provider

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Sets up agent-shell-qwen-authentication for an OpenAI-compatible provider like OpenRouter, passing an API key and setting the base URL and model via agent-shell-qwen-environment.

```Emacs Lisp
;; With string
(setq agent-shell-qwen-authentication
      (agent-shell-qwen-make-authentication :openai-api-key "your-openai-api-key-here"))

;; With function
(setq agent-shell-qwen-authentication
      (agent-shell-qwen-make-authentication
       :openai-api-key (lambda () (auth-source-pass-get 'secret "openrouter-api-key"))))

(setq agent-shell-qwen-environment
      (agent-shell-make-environment-variables
       "OPENAI_BASE_URL" "https://openrouter.ai/api/v1"
       "OPENAI_MODEL" "x-ai/grok-4.3"))
```

--------------------------------

### agent-shell-markdown entry point signatures

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-markdown.md

Shows the function signatures for the main entry points: agent-shell-markdown-convert, agent-shell-markdown-replace-markup, and agent-shell-markdown-context. These are the primary APIs for converting markdown and rendering markup in a buffer.

```elisp
(cl-defun agent-shell-markdown-convert (markdown)                                   ; line 303
(cl-defun agent-shell-markdown-replace-markup
    (&key force complete (render-images t) (highlight-blocks t) image-cache-directory)  ; line 322
(defun agent-shell-markdown-context ()                                              ; line 524
```

--------------------------------

### Implement custom permission responder

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-events.md

Example of a custom responder function that auto-approves read requests if an allow_once option is available.

```elisp
;; auto-approve read requests only
(setq agent-shell-permission-responder-function
      (lambda (permission)
        (when-let* (((equal (map-elt (map-elt permission :tool-call) :kind) "read"))
                    (choice (seq-find
                             (lambda (option)
                               (equal (map-elt option :kind) "allow_once"))
                             (map-elt permission :options))))
          (funcall (map-elt permission :respond)
                   (map-elt choice :option-id))
          t)))
```

--------------------------------

### Configure OpenAI authentication with API key

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

Sets up agent-shell-openai-authentication using an API key. Supports a string key or a function that retrieves the key from auth-source-pass.

```Emacs Lisp
;; With string
(setq agent-shell-openai-authentication
      (agent-shell-openai-make-authentication :api-key "your-openai-api-key-here"))

;; With function
(setq agent-shell-openai-authentication
      (agent-shell-openai-make-authentication
       :api-key (lambda () (auth-source-pass-get 'secret "openai-api-key"))))
```

--------------------------------

### List agent-shell custom variables

Source: https://github.com/xenodium/agent-shell/blob/main/README.org

A utility script to programmatically retrieve and sort all custom variables starting with the agent-shell prefix.

```emacs-lisp
(let ((rows))
  (mapatoms
   (lambda (symbol)
     (when (and (string-match "^agent-shell"
                              (symbol-name symbol))
                (custom-variable-p symbol))
       (push `(,symbol
               ,(car
                 (split-string
                  (or (documentation-property symbol 'variable-documentation)
                      (get (indirect-variable symbol)
                           'variable-documentation)
                      (get symbol 'variable-documentation)
                      "")
                  "\n")))
             rows))))
  (sort rows (lambda (a b)
               (string< (symbol-name (car a))
                        (symbol-name (car b))))))
```

--------------------------------

### agent-shell-submit

Source: https://github.com/xenodium/agent-shell/blob/main/_autodocs/api-reference/agent-shell-core.md

Submits the live prompt to the agent, queuing it if the agent is busy. With a prefix argument, routes through the override function for steering.

```APIDOC
## agent-shell-submit

### Description
Submits the live prompt, queuing it while the agent is busy (via `agent-shell-busy-submit-default-function`). With prefix `ARG`, routes through `agent-shell-busy-submit-override-function` (steering by default). Raises `user-error` "Starting agent, please wait" if the ACP session is not ready yet.

### Signature
`(defun agent-shell-submit (&optional arg))`

### Parameters
- **arg** (optional) - Prefix argument; when non-nil, uses the override submit function.

### Behavior
- Queues the prompt if the agent is busy.
- With prefix, uses the override function for steering.
- Raises `user-error` if the ACP session is not ready.
```
Tokens:
Raw