# nextjournal/clerk

⚡️ Moldable Live Programming for Clojure

Repository: https://github.com/nextjournal/clerk
Canonical: https://ross.abutalabs.com/products/clerk
Homepage: https://clerk.vision
Language: Clojure
License: ISC
License Family: permissive
Topics: clojure, live-programming, moldable-development, visualization, repl, notebook
Last push: 2026-08-12T13:35:10+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 97, release rhythm 35, longevity 100
- inputs: {"age_days": 2004, "days_push": 21, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2079, forks 87 (observed 2026-08-28T04:06:11.502906+00:00)

## What it is
Clerk is a notebook library for Clojure that turns plain Clojure namespaces or Markdown files into rich, interactive computational notebooks. It runs inside your existing Clojure process and editor, evaluates top-to-bottom with incremental recomputation via a var dependency graph, and supports rich viewers and static HTML publishing.

## Use cases
- create computational notebooks in Clojure without Jupyter
- mix prose and executable code in version-controlled notebooks
- visualize Clojure data with rich viewers like Vega and Plotly
- build custom moldable viewers for domain-specific data
- publish static HTML documentation from Clojure code
- explore datasets interactively from the REPL

## When to choose
- you write Clojure and want notebook-style exploration without leaving your editor
- you need notebooks that are plain source files safe for git
- you want incremental, dependency-aware recomputation instead of out-of-order cell execution
- you need extensible custom viewers for your data types

## When to avoid
- you need a Python or R notebook ecosystem like Jupyter
- you want a built-in editing UI rather than using your own editor
- you need a fully stable API - Clerk is explicitly in alpha with breaking changes expected
- you work outside the JVM/Clojure ecosystem

## Facets
- artifact type: library
- maturity: experimental
- function: data-visualization, documentation, developer-tools
- domain: data-science, data-visualization, developer-tools, documentation
- platform: jvm, jvm-scripting, self-hosted
- tags: notebook, live-programming, repl, clojure, moldable-development, incremental-computation, static-publishing, web-server

## Member repositories
- nextjournal/clerk (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:11.502906+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:56:04.636855+00:00, confidence not recorded.
  - readme: https://github.com/nextjournal/clerk (fetched 2026-08-28T04:06:11.502906+00:00, sha c9c30c3154ac)
  - homepage: https://clerk.vision (fetched 2026-08-29T10:36:10.776397+00:00, sha 21aae3731767)
- Data as of 2026-08-30T08:39:29.467469+00:00.