kalidke/ship-of-tools

Ship of Tools is an agentic development environment for Julia: you and a Claude Code session share one Julia REPL, in a desktop window that also shows your figures and files; Codex sessions run alongside without it for now. Linux; Windows and macOS run as frontends to a Linux backend (macOS is experimental). See Platforms.
A Claude Code session edits the script, runs it in the shared Julia REPL, and shows the new chart (navigation column cropped). Documentation
The default layout with the Julia drawer open.
The window is GPU-rendered, with a keyboard-driven, terminal-style layout: a navigation tree, a file preview, an agent pane and a Julia REPL drawer. The agents write code and run it in the persistent REPL while you watch and review the results.
Compared with Claude Code next to a REPL in tmux, or with VS Code, its Julia extension and a Claude Code panel:
The agent and you share one REPL.
Figures, PDFs and typeset math render in one keyboard-driven window.
The backend and its sessions keep running on the server when the window closes.
## What it does
Agents
Each session is a row running Claude Code, Codex or a plain shell, coloured by its work state so you can see which one needs you.
Claude Code sessions run Julia in the session's persistent REPL, and each run appears in your REPL drawer.
Sessions message each other over a built-in relay and can start sessions for worktrees and other repos.
An agent can open a file or figure in your preview pane to show you what it produced, and you can hand it a file path or a cropped region of an image.
There is no diff view of its own: you review the agent's edits in the preview pane, which follows a file as it changes on disk, in the REPL drawer, which shows every run the agent made, and with git in a shell session. To change a file yourself, focus the preview and press e for the built-in editor; Ctrl+S saves.
Julia live loop
A persistent REPL per session. r on a .jl file runs it in a fresh REPL, restarting the session's REPL and dropping whatever the agent had built in Main; Shift+R includes it in the current one. The drawer is Ship of Tools' own input line, with pkg mode (]) and history, but no ? help, ; shell or Tab completion. See Dispatching code.
CairoMakie figures render in the window. wglshow(fig) opens an interactive WGLMakie figure in your browser; Pluto notebooks run on the backend host.
Previews
The preview pane renders the file under the cursor: markdown with typeset math, paged PDF, images, HDF5 structure, syntax-highlighted Julia, a video poster frame.
Same-size images in a directory share pan and zoom, so stepping through a run's plots keeps the framing.
Modules mode lists a package's modules and their definitions: types, functions, macros and submodules.
Machines
The backend runs where the data and GPUs are; the window runs on your laptop and attaches over SSH.
Several frontends can attach to one backend at the same time.
With a remote backend, sessions keep running when the laptop lid closes, and sessions, REPLs and agents survive a frontend restart. A monitor drawer shows CPU, memory and GPU across your Linux hosts.
Extend
Add a preview for a new file type in Julia, with no Rust changes. The built-in text, source, PDF and video previews use the same interface.