01
Many Lisps, one window
Six dialect profiles pick the runtime for whatever file is open. Jolt runs in or out of process, jank and ClojureScript are launched for you, and the rest attach over nREPL.
Jonquil
Alpha · macOS (Apple Silicon) · Linux from source · open source, EPL-2.0
Jonquil is a DrRacket-style editor for Jolt, Clojure, ClojureScript, jank, Basilisp and babashka. Edit code at the top, press Run, see the results in a REPL underneath, and Stop really stops a runaway program. On Jolt it goes further: your program runs on the editor's own runtime, so the inspector and the debugger see its real values.
Runs
Why Jonquil
The DrRacket loop for every Lisp you use, and on Jolt, the tools of a Lisp Machine.
01
Six dialect profiles pick the runtime for whatever file is open. Jolt runs in or out of process, jank and ClojureScript are launched for you, and the rest attach over nREPL.
02
Describe Key, the locations list, presentations in the console, Save World, the Processes panel: ideas from the MIT CADR and Symbolics Genera, working on your program's live values.
03
A plugin is one Clojure file of commands, keys, hooks and agent tools. An agent can drive the window over MCP, and a dialect profile is the plug point for the next Lisp.
Run and Stop
Run evaluates everything in the editor, the REPL prompt evaluates one line, and Stop ends a program even when it's spinning in a loop. It's the DrRacket loop, for every dialect.
read-line reads from the console, so stdin just worksLisp Machine ideas, on Jolt
Emacs is extended in a different Lisp from the one you write. Jonquil is written in Clojure on Jolt, and your Jolt code runs on that same runtime, so the tools look at real values, not the editor's.
Debugging
On Jolt: breakpoints, Step Into, Over and Out, Break on error, and the last error's frames with every local. Retry, Edit and retry, and Define and retry pick a failed evaluation back up in every dialect.
Help
Completion with a doc preview, quick doc, jump to definition and rename all ask the live runtime, whichever Lisp it is. The menus and the command palette list every command with its key.
nsStructural editing and keys
Jonquil has 42 structural editing commands, and they follow Calva's paredit. Slurp, barf, drag, splice and wrap all leave the brackets balanced. You'll find them under Edit > Structure and in the command palette, or you can turn on the Calva paredit key set to get Calva's keys.
keys.edn, and a key you set shows in the menus at onceTerminal, for macOS first
Ctrl+` or Terminal in the View menu shows a terminal under the editor, on a tab beside Interactions. A login shell starts in your project's folder and keeps running until you close the window.
Agents
jonquil --mcp serves six tools over MCP with no window. Add --window and an agent opens, edits, saves and runs tabs while you watch, through twenty tools.
--mcp-attach bridges to a window you already have openDialects and runtimes
Jonquil picks a dialect profile for whatever file is open, and its status bar says which one and whether the runtime is up.
Jonquil's own Lisp, and the one breakpoints, stepping and Break on error need. A program in a deps.edn project runs out of process over nREPL, so one that crashes or calls System/exit takes down a child, not Jonquil. A loose file runs in Jonquil's own process.
Tour
Every screenshot here is captured from the real app by Jonquil's own docs harness. Click one for a closer look.
Themes
Light is the default. Cmd/Ctrl+Shift+M cycles through them all, or type "theme" in the command palette to pick one by name. Auto follows your Mac's Light or Dark mode, and a theme recolours the whole window. More in the guide.
A plugin adds commands and keys, hooks on saves, Runs and errors, and tools an agent can call. Each version that goes live is kept, so you can see its history and revert.
Read more~/.config/jonquil/plugins/wrap-when.clj
(p/defplugin
{:id :wrap-when
:doc "Wrap the form at the caret in (when ...)."
:effects #{}
:commands
[{:id :wrap-when/wrap :scope :editor
:edit (fn [snapshot]
(p/wrap-form snapshot "(when " ")"))}]})A dialect is a profile: what its files look like, how they're painted, which evaluator runs them. A profile's port file is most of what an attach runtime needs.
Read moreOff by default. Turn on Smart and each open bracket closes itself as you type, dedenting a body line pulls the closer up, and indenting pulls it back in. Cmd/Ctrl+Shift+M cycles through the themes.
Read moreProvenance
Jonquil ports the idea of DrClojure and lifts its pure text-analysis code: the tokenizer, brackets, smart indent, the formatter. The front end is GTK4 on direct FFI, rebuilt in Jolt, and the Jolt fixes the project needed went upstream.
On main, not yet in a release CHANGELOG
jonquil_namespaces lists the loaded namespaces, jonquil_vars lists a namespace's vars with their arglists, first doc…New in 0.5.0
jonquil_eval, jonquil_run, jonquil_run_file and jonquil_run_selection) answer with structured content beside their text: the status, the…max_output_chars (default 100000). A program that prints more than that gets an answer holding the last characters and a first line saying how many were dropped.Get started
Signed and notarized, for Apple Silicon Macs on macOS 26 or newer. GTK comes inside the app, so it opens and runs a file straight away. To run a project (a folder with a deps.edn), also install Jolt and git. Intel Macs and Linux build from source.
With Homebrew, which also puts a jonquil command on your PATH:
brew install b12n-oss/tap/jonquil
Or download it:
sha256 c5b92fe87b27e99d372858df6b500682be434554d93ae17bd5b7786c8b3146d5
sha256 fd5bbbf2ae6981de0481b1151ecc5a0730ce62bbab1f0da0c72fc294b149f7e1
Alpha software. Some dialects are experimental, and Known limits lists the rough edges for each runtime.