About this project

Litrepl is a command-line processor designed for Markdown and LaTeX documents that contain literate programming code sections. It evaluates and updates those sections through background interpreters, which can remain active for a read-eval-print-loop (REPL) style of interaction. The tool supports multiple interpreters including Sh, Bash, Python, IPython, and Aicli. It integrates with the Vim editor via an included plugin, allowing users to evaluate code blocks directly from within their editor. The project also offers integration with Vimtex for instant LaTeX document editing and preview. Key features include support for both Markdown and LaTeX document formats, background interpreter management for persistent REPL sessions, and a Vim plugin for seamless editor integration. The tool relies on POSIX-compatible operating systems (typically Linux) and depends on Python packages lark-parser and psutil. Socat is optionally required for certain REPL and Vim LTerm commands. Litrepl is published as a peer-reviewed tool in the Journal of Open Source Software (JOSS) and has an associated preprint on arXiv (2501.10738) titled 'Litrepl: Literate Paper Processor Promoting Transparency More Than Reproducibility.' The project provides comprehensive documentation on its GitHub Pages site covering installation, basic usage, and document formatting.