pi-emacs

A collection of Emacs-related extensions for pi-coding-agent.

Installation

This package can be installed via npm:

pi install npm:pi-emacs

Or by adding it to your ~/.pi/settings.json:

{
  "packages": ["npm:markokocic/pi-emacs"]
}

Extensions

emacs_eval

Evaluates Emacs Lisp code via emacsclient CLI. Supports heredoc-style multi-line code input.

Requires: Emacs server running (M-x server-start in Emacs).

Parameters: | Parameter | Type | Description | |-----------|------|-------------| | code | string | Emacs Lisp code to evaluate | | timeout | number (optional) | Timeout in seconds (default: 30) | | noWait | boolean (optional) | Don't wait for response (fire and forget) | | quiet | boolean (optional) | Suppress success messages | | socketName | string (optional) | Emacs socket name |

Returns:

• stdout - Evaluation result from Emacs
• stderr - Standard error output
• errors - Any errors encountered
• success - Whether evaluation succeeded

Example usage:

;; Query Emacs version
(princ emacs-version)

;; Get current buffer name
(buffer-name (current-buffer))

;; Set a variable
(setq my-var "hello")

;; Query a variable
(message "%s" my-var)

Development

# Link for local development
cd ~/.pi/agent/extensions
ln -s /path/to/pi-emacs/extensions ./pi-emacs

# Or reference in package.json
"pi": {
  "extensions": ["/path/to/pi-emacs/extensions/index.ts"]
}