Documentation
Commentary
Emacs frontend for the pi coding agent (https://pi.dev).
Provides a two-window interface for AI-assisted coding: chat history
with rendered markdown, and a separate prompt composition buffer.
Requirements:
- Emacs 29.1 or later (tree-sitter support required)
- pi coding agent @earendil-works/pi-coding-agent 0.79.1 or later, installed and in PATH
- tree-sitter grammars for markdown and markdown-inline
pi-coding-agent uses `md-ts-mode` for its own chat and input buffers;
loading it does not change global Markdown file associations.
Usage:
M-x pi-coding-agent Start or focus session in current project
C-u M-x pi-coding-agent Start a named session
M-x pi-coding-agent-open-session-file Open a JSONL session file as live session
M-x pi-coding-agent-toggle Hide/show session windows in current frame
Many users define an alias: (defalias 'pi 'pi-coding-agent)
Key Bindings:
Input buffer:
C-c C-c Send prompt (queues as follow-up if busy)
C-c C-s Queue steering (interrupts after current tool; busy only)
C-c C-k Abort current operation
C-c C-p Open menu
C-c C-r Resume session
M-p / M-n History navigation
C-r Incremental history search (like readline)
TAB Path/file completion
@ File reference (search project files)
Chat buffer:
n / p Navigate messages
TAB Toggle completed thinking/tool section or fold turn
RET Visit file at point (from tool blocks)
C-c C-p Open menu
Editor Features:
- File reference (@): Type @ to search project files (respects .gitignore)
- Path completion (Tab): Complete relative paths, ../, ~/, etc.
- Message queuing: Submit messages while agent is working:
C-c C-c queues follow-up (delivered after agent completes)
C-c C-s queues steering (interrupts after current tool)
Press C-c C-p for the full transient menu with model selection,
thinking level, completed-thinking controls, session management,
and custom commands.
See README.org for more documentation.
Requires
Dependencies
Consumers
Reverse Dependencies
No reverse dependencies recorded.