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

One command installs vis-agent — the only Vis command there is.

curl -fsSL https://github.com/Blockether/vis/releases/download/installer/install-vis-agent | bash
vis-agent help

vis-agent runtime show      # what is installed and selected
vis-agent update            # move the command and its runtime to the newest commit

Clojure library:

;; deps.edn
{:deps {com.blockether/vis {:mvn/version "0.1.34"}}}

Companion app (iPhone / Android)

Vis Companion is the phone client for a Vis gateway you run yourself — it drives the same sessions as the TUI (see Gateway & pairing). Both stores are in public testing; no invite, no tester list, just the link.

Platform	Public test link	Status
iOS / iPadOS	https://testflight.apple.com/join/4anYT4Wk	TestFlight public link, open to anyone with the URL (requires the free TestFlight app)
Android	https://play.google.com/apps/testing/com.blockether.viscompanion	Play open testing (beta track), package com.blockether.viscompanion

The app is useless on its own: it needs a gateway. Start one with vis-agent gateway, then pair by scanning the QR it prints. Feedback goes to karol@blockether.com (or the TestFlight feedback button).

Choose the runtime

vis-agent follows the releases by default. A live checkout is dev mode — opt in; it is never picked for you.

Runtime	Runs
native	the private sidecar downloaded by vis-agent update
jvm	source pinned to the newest vX.Y.Z tag
dev	a live checkout (~/vis, or $VIS_DEV_CHECKOUT), tracking its branch
auto	no choice at all: native if installed, else tagged source

With nothing at the dev path, vis-agent update clones the repository there on main.

vis-agent update native|jvm|dev             # acquire it, update it, select it
vis-agent runtime show
vis-agent runtime use native|jvm|dev|auto   # switch only (auto = forget the choice)
vis-agent --native|--jvm|--dev help         # one launch only
VIS_RUNTIME=dev vis-agent help              # one process only

A one-launch flag beats VIS_RUNTIME, which beats the persisted default in ~/.vis/runtime. vis-agent update updates the runtime in effect; naming one (vis-agent update dev) also makes it the default. A selected runtime that is not installed is an error, never a silent substitution. Full matrix: Runtime distributions.

License

Apache License 2.0 — see LICENSE.