Other Platforms

Overview

Here "other platforms" means any Clojure-like runtime that ships an nREPL server but doesn’t have a dedicated section of its own earlier in this documentation. These runtimes typically implement only the core nREPL protocol, without the cider-nrepl middleware, so you get evaluation, loading and the other core-nREPL basics, but not CIDER’s cider-nrepl-powered features. See the overview for the bigger picture.

Usage

The default connection command cider-connect-clj can connect to any nREPL server that implements the core nREPL protocol, so all you need to do is:

  • Start the runtime’s nREPL server (its README usually explains how).

  • M-x cider-connect-clj <RET>

That’s it. You’ll get every feature the nREPL server you’re connecting to implements.

Supported platforms

Here’s an incomplete list of Clojure-like runtimes you can use as described above:

For nbb you can alternatively connect via cider-connect-cljs, see nbb.

Limitations & caveats

  • Everything is treated as a Clojure connection, regardless of the underlying runtime.

  • Errors are displayed only as overlays (the dedicated CIDER error buffer isn’t wired up for these connections).

  • How much functionality you get depends on how completely the runtime implements the core nREPL protocol.

  • Advanced, cider-nrepl-powered features (debugger, inspector, test runner, tracing, profiling, and so on) are unavailable unless the runtime bundles a compatible middleware.