Vis

Vis is a coding agent that writes Python into a sandboxed GraalPy runtime, keeps durable state outside the context window, and inspects/changes the host project through tools.

Install

Two ways, one per platform. Each clones Vis, checks the runtime tools, and puts the vis launcher on your PATH.

macOS & Linux (bash):

curl -fsSL https://raw.githubusercontent.com/Blockether/vis/main/bin/install-source | bash

Windows (PowerShell):

iwr https://raw.githubusercontent.com/Blockether/vis/main/bin/install-source.ps1 -OutFile install-vis.ps1
powershell -ExecutionPolicy Bypass -File .\install-vis.ps1

Then confirm:

vis help

Prereqs: git, java 21+, and the Clojure CLI 1.12+ — the installer checks for them and tells you what's missing. Building the native binary locally needs Oracle GraalVM or GraalVM CE 25+ with at least 16 GB RAM.

What vis runs

vis is the stable command. It proxies to the best available distribution, in this order:

1. managed native binary from vis update ($VIS_HOME/install, default ~/.vis/install)
2. repo native binary (target/vis or target/vis.exe)
3. repo JVM uberjar (target/vis.jar)
4. live source (clojure -M:vis)

Use vis --jvm ... to skip native and force the JVM path.

Build / develop

vis native          # builds target/vis(.exe) and target/vis.jar
./bin/dev nrepl    # project nREPL
./verify.sh --quick

Contributor rules: AGENTS.md.