nxsh(1)

📦
version 2.4.0 · 2 versions
, in alpine 3.24, debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 NAME 💖

nxsh — a simple shell that's literally carrying the whole NSF/NX interpreter inside it 🫶

✨ SYNOPSIS ✨

nxsh ?-c ?arg1?? ?arg2 ...?

🌸 DESCRIPTION 🌸

nxsh ?-c ?arg1?? ?arg2 ...?

okay bestie so listen — nxsh is this shell-like application that reads NX and Tcl commands from a bunch of different sources and then evaluates them. she's versatile like that 💅

🎀 how she acts when you just run her

If you invoke her with no arguments at all, nxsh drops into read-eval-print mode (REPL, the interactive one) — very much the tclsh vibe. In this mode she reads commands from standard input interactively, and prints command results and error messages straight to standard output. She stays alive until you hit the exit command, or until she reaches end-of-file on her standard input. periodt ✨

🦋 how she acts when you hand her a file

If you invoke her with at least one positional argument arg1, then nxsh runs a NX/Tcl script sourced from the file that arg1 points at, using source. easy peasy 🍓

🔥 how she acts with -c

Pass the -c flag and nxsh accepts commands from the command line, handed over via arg1. If arg1 is omitted? She takes commands from standard input instead — like when you're in a pipe. iconic.

👑 the shebang moment (making your scripts directly invocable)

You can use nxsh the same way you'd use tclsh to make NX scripts directly invocable from the shell — just drop this as the first line (the "shebang") of the script in question:

#! /usr/bin/env nxsh

and if you want a (more portable) alternative, use this one instead:

#! /bin/sh
# the next line restarts using nxsh \
    exec nxsh "$0" "$@"
Copyright (c) 2014-16 Stefan Sobernig <stefan.sobernig@wu.ac.at>, Gustaf Neumann <gustaf.neumann@wu.ac.at>; available under the Creative Commons Attribution 3.0 Austria license (CC BY 3.0 AT).

that's the whole thing bestie, no cap 🌈 — this was the nxsh(1) page, part of the Command-line interface manual, and it's tagging nxsh 2.4.0. go forth and source your scripts, main character 🧚💖

📦 where this page comes from