Allowlist, not guesswork
ls, cat, grep and five other native commands. No interpreters, scripts, unknown flags, or subprocess forwarding.
The terminal built to look, not touch. A small, intentional set of read-only commands, backed by OS-specific kernel restrictions—so inspection stays inspection.
Illustrative terminal output
01 / THE IDEA
ReaTerm does not try to guess which Bash commands are safe. It only implements read-only inspection operations and rejects everything else.
ls, cat, grep and five other native commands. No interpreters, scripts, unknown flags, or subprocess forwarding.
Linux requires Landlock and seccomp; macOS uses Seatbelt; Windows uses a low-integrity write-restricted access token. Enforcement failures stop the command.
KERNEL / 002Read paths are relative to a caller-chosen root. File sizes, output and directory listing lengths are bounded. No hidden command hooks.
DESIGN / 00302 / UNDER THE HOOD
The parser validates the entire request. Only explicit read operations can reach the native filesystem reader after mandatory kernel confinement is installed.
03 / QUICK START
Choose your integration. Each path uses the same compiled native engine and requires Linux with Landlock and seccomp, macOS with Seatbelt, or Windows x86-64 with a low-integrity write-restricted token.
Clone the repository and install the binary into Cargo's bin directory. Run commands directly from your terminal.
git clone https://github.com/Pro-GenAI/ReaTerm.git
cd ReaTerm
bash scripts/install.sh
reaterm ls -la
reaterm cat README.mdCargo's bin directory must be on PATH. Alternatively, build via cargo build --release --manifest-path src/rust/Cargo.toml.
Install the adapter from this repository. The compiled Rust binary must be available on PATH or specified using REATERM_BIN.
# From the repository root, after building the native binary
python -m pip install -e src/python
python -c 'from reaterm import ReaTerm; print(ReaTerm(root=".").run("ls", "-la"))'Run this example from the repository root. For optional model checks, use the src/python[decision] extra.
Build the local TypeScript package. Your application calls the Rust binary through a shell-free argument vector.
// After npm install && npm run build in src/typescript
import { ReaTerm } from "@pro-genai/reaterm";
const term = new ReaTerm({ root: "." });
console.log(await term.run("cat", "README.md"));Requires Node.js 20+. See the TypeScript package source for build instructions.
04 / INTEGRATIONS
Install locally from source today. Package registry listings are linked for discovery, but publication status has not been verified.
The security boundary. All commands are implemented directly in Rust.
cargo install --path src/rustExplore Rust source Use ReaTerm with Python 3.9+, with an optional model-based veto.
pip install -e src/pythonPython package source PyPI registry listing Call the same binary from Node.js 20+ with no shell involved.
npm install && npm run buildnpm package source npm registry listing Registry availability is not guaranteed. Use the repository source and installation instructions above until a package is confirmed published.
05 / THE BOUNDARIES
Read-only means the ReaTerm process does not implement writes. It is not a replacement for a trusted launcher or a confidentiality control.
Read the full threat modelParent shells are separate. Redirecting reaterm ls > file.txt can still create or truncate a file before ReaTerm starts.
Inherited descriptors matter. Landlock does not revoke previously opened file descriptors; launch it from a trusted process.
The root is caller-selected. ReaTerm is not a tool for hiding files inside an otherwise readable directory.
Linux, macOS and Windows x86-64. Other Windows architectures and 32-bit ARM are unverified. Windows token protection is thread-scoped.
READY TO INSPECT?
Start with the Rust CLI, or build against the same engine using Python or TypeScript.