Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

RexxSheet: a spreadsheet you can script in REXX

A spreadsheet with two formula languages, Excel's and RexxJS's, and every action a command that a REXX script can drive. This repository has three parts:

Folder What it is License
app/ The spreadsheet, current. A sae app in sae's TypeScript dialect: it runs as a page in the sae browser or as an installed app, natively on aether-ui (GTK4, AppKit, Win32). MIT
rexx/ REXX scripts that drive the running sae app from outside, over its control bus (ADDRESS SPREADSHEET, through sae's sae-bus). MIT
mcp/ An MCP server, so an AI client (Claude, or any MCP client) drives the app: one it starts itself and talks to over sae's stdin and stdout (no file, nothing listening), or with --attach one already running with its control bus on. MIT

The original React + Tauri app the sae one grew from was here as tauri/ until 2026-10-15; it is in this repository's history (last at commit bd1a002), AGPL as it was.

The sae app

app/ began in sae as its demo 18 and moved here on 2026-10-14; its history up to then is in sae's git log (to sae commit 61e4adb). What it does and what is still to do: docs/spreadsheet_demo_done_and_todo.md. The bugs it found in the Tauri app: docs/tauri-spreadsheet-upstream-notes.md. Where it is going: TODO.md, small tested steps toward the feature set of GridCraft (where it stands: docs/comparisons/gridcraft_parity.md; the yardstick: docs/comparisons/gridcraft_feature_reference.md, its source never read) and a toolbar and menus over the grid, each step reachable from REXX.

Action lists drawn from other spreadsheets for the current Aether/AetherUI/sae app: LibreOffice, Grist, HyperFormula, Univer, IronCalc, Gnumeric, VisiData, and Airtable.

app/
  app.json          the installed app's manifest: its start page and grants
                    (documents, the control bus)
  sheet.ts          the page: panels declared over the commands
  sheet/            the spreadsheet with no ui: workbook, sheets, both formula
                    languages, every command (commands.ts), RexxJS (rexxjs.js,
                    generated)
  sheet/view/       the ui: each panel reads the workbook and runs commands
tests/
  headless/         the model and commands, no window: sae's lowerer harness
                    on sae's QuickJS (sheet -> ../../app/sheet)
  specs/            the app driven in sae-driver: grid, keys, clipboard, files,
                    the control bus, rexx/'s scripts and mcp/'s server run against it
  lib/griddriver.ae reads and clicks the datagrid for the specs
  mcp/              the MCP server's tests (node --test): its protocol, with
                    stand-ins for sae-bus and sae; and the real app driven
                    over its control channel (channel.test.js)
vendor/rexxjs/      RexxJS's interpreter and parser, vendored (MIT, its LICENSE)
tools/              bundle-rexxjs.mjs: re-vendors RexxJS and writes app/sheet/rexxjs.js
docs/               the plan, and notes for the Tauri app
rexx/               REXX scripts that drive the app, and their ADDRESS library
mcp/                an MCP server, so an AI client drives the app (sae-channel.js:
                    the app started on sae's stdin and stdout)
sae -> ../sae       the sae checkout it builds and tests against
RexxJS -> ../RexxJS the RexxJS checkout the REXX scripts run on

Running it

It needs sae checked out beside this repository (the sae symlink points at ../sae) and built, as sae's AGENTS.md "Build and test" says. Then:

../sae/target/build/bin/sae --app app

--control-bus after it switches on the control bus, so other programs on this machine can drive the sheet (sae's docs/control-bus.md): a loopback port, and its key in a file only you can read. A program that starts the app itself needs neither: the MCP server and cli/sheet.js start it with --control-stdio and drive it over its own stdin and stdout, which only they hold (sae's docs/app-backend.md, "The control channel").

Testing it

./run-tests.sh

It needs node, and RexxJS checked out beside this repository, for the REXX scripts' spec and the MCP server's tests (and lsof, for what listens). That runs the headless tests, the MCP server's tests and the specs, one line of PASS or FAIL each, with logs under target/run-tests/. ./run-tests.sh headless runs only the headless tests; ./run-tests.sh spec_sheet only that spec. SAE_DIR=... picks another sae checkout. On Linux with no display it runs under xvfb-run.

Re-vendoring RexxJS

node tools/bundle-rexxjs.mjs ../RexxJS

copies RexxJS's interpreter and parser into vendor/rexxjs/ (recording the commit in UPSTREAM) and regenerates app/sheet/rexxjs.js. RexxJS is the canonical source of the REXX language; changes to it go there first.

REXX scripts

With the app started with --control-bus, from the repository's root:

RexxJS/core/rexx rexx/test-spreadsheet-address.rexx

See rexx/README.md: how a command reaches the app, and where the scripts differ from the Tauri app's.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages