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.

Consumers

Reverse Dependencies

No reverse dependencies recorded.