⌨️ LitRepl ⌨️

Changelog | Installation | Usage | Gallery

Litrepl is acommand-line processor for Markdown or LaTeX documents with literate programming code sections. Instructed by its arguments, it evaluates and updates sections via background interpreters. Interpreters can stay active for a read-eval-paste-loop style.

Notes:

• Literate programming
• Read-eval-print loop

Preprint: (2025, Sergei Mironov) Litrepl: Literate Paper Processor Promoting Transparency More Than Reproducibility arXiv:2501.10738

Features

• Document formats
  Markdown (Example [MD]) | LaTeX (Examples [TEX][PDF])
• Interpreters
  Sh | Bash | Python | IPython | Aicli
• Editor integration
  Vim (plugin source included)

Requirements

• POSIX-compatible OS, typically a Linux. The tool relies on POSIX operations, notably pipes, and depends on certain Shell commands.
• lark-parser and psutil Python packages.
• Socat (Optional) Needed for litrepl repl and Vim's LTerm commands to work.

Documentation

• Installation
• Basic usage
• Formatting documents

For full documentation, check out the project's GitHub Pages site.

Gallery

Basic usage (Show GIF)

(Outdated!) AI capabilities (Show GIF)

Vimtex integration (Show Video)

We utilize LitRepl alongside the Vimtex plugin to edit and preview LaTeX documents instantly.

demo-vimtex.mp4