Getting Started

Install Sessions.jl and start working with reactive Julia notebooks in your terminal.

Installation

Sessions.jl requires Julia 1.12+. Install it as a Julia app:

julia
using Pkg
Pkg.Apps.add(url="https://github.com/GroupTherapyOrg/Sessions.jl")

This installs the sessions command to ~/.julia/bin/. On first launch, JETLS (real-time diagnostics) is auto-installed.

Quick Start

Sessions.jl can be used in three ways:

CLI (recommended)

bash
# Open a notebook
sessions my_notebook.jl

# Create a new notebook
sessions

# Run headlessly (CI, scripts)
sessions run my_notebook.jl

Julia REPL

julia
using Sessions
Sessions.main("my_notebook.jl")

Headless execution

Run all cells in a notebook without the TUI. Useful for CI pipelines and batch processing.

bash
sessions run my_notebook.jl

Dependencies

Sessions.jl builds on the Julia and Pluto ecosystems: