logseq-runit-plugin

A Logseq plugin for running code snippets directly inside your notes.
Supports JavaScript, Python (via Pyodide), Scheme (via BiwaScheme), and Clojure (via SCI) with interactive output.
Built for Logseq.

Features

• Multi-language support: Run JavaScript, Python, Scheme, and Clojure code blocks
• Console output capture: See console.log/print output inline
• Last expression result: Automatically displays the result of the last expression, similar to Jupyter notebooks
• Dynamic imports: Supports dynamic module imports for JavaScript
• Easy insertion: Use the /Create Runit Snippet slash command to insert runnable code blocks

Usage

1. Install the plugin in Logseq
2. Use the /Create Runit Snippet command to insert a code block
3. Write your code in JavaScript, Python, Scheme, or Clojure inside the block
4. The output and console logs will be displayed below the code

Note: When using the /Create Runit Snippet command, ensure the generated macro remains attached to the current block. Use Shift+Enter for line breaks within the same block before running the slash command, rather than creating a new separate block.

Importing External JavaScript Modules

You can import external JavaScript modules using the $import function:

const R = await $import('https://esm.sh/ramda')

R.map(v => v + 1)([1, 2, 3, 4])

// output
Array [
  2,
  3,
  4,
  5,
]

The $import function supports both URLs and module names, allowing you to use libraries from CDNs like esm.sh directly in your code snippets.

Google Charts Integration

You can create interactive charts using Google Charts:

const chart = await $import('google-charts')
const data = [
  ['Task', 'Hours per Day'],
  ['Work',     11],
  ['Eat',      2],
  ['Commute',  2],
  ['Watch TV', 2],
  ['Sleep',    7]
]
const options = {
  title: 'My Daily Activities',
  width: 500,
  height: 300
}
chart.render('PieChart', data, options)

The Google Charts integration supports various chart types including PieChart, BarChart, LineChart, ScatterChart, Gauge, GeoChart, and Table. Charts are rendered as interactive SVG elements directly in your notes.

For more chart types and configuration options, see the Google Charts Gallery.

Python Support

The plugin supports running Python code via Pyodide, bringing the full Python scientific computing stack to your browser.

Basic Python Usage

#% pip install numpy

import numpy as np

# Create a simple array
arr = np.array([1, 2, 3, 4, 5])
print("Array:", arr)
print("Sum:", np.sum(arr))
print("Mean:", np.mean(arr))

# Return the result
arr * 2

Creating Plots with Matplotlib

#% pip install matplotlib numpy

import matplotlib.pyplot as plt
import numpy as np

# Create data
x = np.linspace(0, 10, 100)
y1 = np.sin(x)
y2 = np.cos(x)

# Create the plot
plt.figure(figsize=(10, 6))
plt.plot(x, y1, 'b-', linewidth=2, label='sin(x)')
plt.plot(x, y2, 'r--', linewidth=2, label='cos(x)')
plt.xlabel('x')
plt.ylabel('y')
plt.title('Trigonometric Functions')
plt.grid(True, alpha=0.3)
plt.legend()

# Render the plot
plt_show()

Scheme Support

The plugin supports running Scheme code snippets via BiwaScheme, allowing you to execute and view results conveniently in your notes:

(define (fib n)
  (if (< n 2) n
      (+ (fib (- n 1)) (fib (- n 2)))))
(fib 8)

Clojure Support

This plugin supports running Clojure code snippets via sci (Small Clojure Interpreter), allowing you to execute ClojureScript code directly in your notes:

(defn factorial [n]
  (if (<= n 1)
    1
    (* n (factorial (dec n)))))

(factorial 5)

SCI provides a safe, sandboxed environment for executing Clojure code with most of the core ClojureScript functionality available.

Development

• Clone the repo and run pnpm install
• Use pnpm dev to start development with hot reload
• Build for production with pnpm build

Acknowledgments

Special thanks to Klipse for inspiration.
Originally, I wanted to integrate Klipse directly, but due to some technical limitations, I implemented a simplified "code runner" based on some of Klipse's ideas.

Note: Currently, code execution happens when the code editor loses focus, which is less interactive compared to Klipse.

License

MIT