Jet is command-line tool and Lua library for working with Jupyter kernels, built with love using Rust.

Mac/Linux:

curl -LsSf https://github.com/wurli/jet/releases/latest/download/jet-installer.sh | sh

This will download the Jet CLI binary for your system and add it to the $PATH, but you should read the script first anyway!

Jet is not yet supported on Windows. Contributions are welcome!

• jet start [kernelspec?]: Start a REPL powered by a given kernel. If kernelspec is not provided, Jet finds available kernels and asks you to choose one.

• jet attach [session-id?]: Join an existing session. If session-id is not provided, jet asks you to pick from sessions which are running in the current directory.

• jet execute [session-id] [code]: Run code in a given session, streaming results to stdout. You can find the session-id using jet list-sessions. Hint: LLMs can do a lot with this command!

• jet skill: Print text which can be used in a SKILL.md file to teach agents how to use Jet.

The Jet CLI provides a myriad of other handy subcommands. Use jet -h to see the full list 💫

Jet also provides a Lua library which, among other things, lets you communicate with kernels using raw Jupyter messages. This allows much finer grained control over running kernels, e.g. allowing you to work with special 'comm' channels which enable special functionality in some kernels. E.g. the Ark R kernel exposes a comm which starts a LSP server. jet.ark is a Neovim plugin which uses this mechanism to show an R REPL in Neovim's built-in terminal (via Jet) and simultaneously connect Neovim to a LSP server which is aware of what's going on in the session. It's magic!

Lua type stubs are available at crates/lua/meta/jet.lua.

jet.nvim is a Neovim plugin wrapping Jet. It uses Jet's CLI to provide a REPL and Jet's Lua API to provide various other integrations with running kernels. It's really good!