res-sh: rescue shell — Lua-extensible applets, static binary #28

New issue

Open

opened 2026-10-12 22:17:11 +00:00 by muse-lantern · 0 comments

muse-lantern commented

2026-10-12 22:17:11 +00:00

Member

Goal

Turn res-sh into the standalone "oh shit" fallback shell: one static binary that opens a shell with all rescue commands available inside it. (Can support multicall argv[0] dispatch, but that is not the primary interface.)

The internal Lua runtime is the extension mechanism: place a Lua script in a special folder and it should just work for the majority of what busybox can do.

Scope

Parser: add &&, ||, ! operators (tier-1). Rescue scripts are written as [ ... ] && ...; without these, test is half-useful.
Applet registry: in-shell dispatch so all commands are available inside the shell with no PATH. Multicall argv[0] dispatch as a bonus.
Lua runtime wiring: wire core/lib/script into res-sh so Lua scripts in a special folder work as commands.
Rescue applets: incremental set — ls, cat, cp, mv, rm, mkdir, rmdir, ln, chmod, touch, head, tail, wc, test/[, mount, umount, df, du, dmesg, ps, ip, clear, uname, echo.
Static build: verify CGO_ENABLED=0 go build produces a working static binary.

Stays out

modprobe/insmod/depmod/mdev — kernel module loading stays on busybox-static (per 2026-10-12 loader decision).

## Goal Turn res-sh into the standalone "oh shit" fallback shell: one static binary that opens a shell with all rescue commands available inside it. (Can support multicall argv[0] dispatch, but that is not the primary interface.) The internal Lua runtime is the extension mechanism: place a Lua script in a special folder and it should just work for the majority of what busybox can do. ## Scope 1. **Parser**: add `&&`, `||`, `!` operators (tier-1). Rescue scripts are written as `[ ... ] && ...`; without these, `test` is half-useful. 2. **Applet registry**: in-shell dispatch so all commands are available inside the shell with no PATH. Multicall argv[0] dispatch as a bonus. 3. **Lua runtime wiring**: wire `core/lib/script` into res-sh so Lua scripts in a special folder work as commands. 4. **Rescue applets**: incremental set — ls, cat, cp, mv, rm, mkdir, rmdir, ln, chmod, touch, head, tail, wc, test/[, mount, umount, df, du, dmesg, ps, ip, clear, uname, echo. 5. **Static build**: verify `CGO_ENABLED=0 go build` produces a working static binary. ## Stays out - modprobe/insmod/depmod/mdev — kernel module loading stays on busybox-static (per 2026-10-12 loader decision).

muse-lantern added the

proj-core-sh

tier-3-hard

labels

2026-10-12 22:17:14 +00:00

muse-lantern referenced this issue from a commit

2026-10-13 03:27:19 +00:00

res-sh: rescue shell foundation — &&, ||, !, applet registry, Lua applets

muse-lantern referenced this issue from a commit

2026-10-13 22:43:59 +00:00

res-sh: rescue shell foundation — &&, ||, !, applet registry, Lua applets