@aitty/node-pty

Small Node runtime wrapper around node-pty.

It owns one real PTY process: spawn, write, resize, replay buffering, and graceful shutdown. It does not manage browser clients, WebSocket transport, or multi-viewport projection.

import { createNodePtySession, loadNodePty } from "@aitty/node-pty";

const nodePty = await loadNodePty();
const session = createNodePtySession({
  cwd: process.cwd(),
  file: "zsh"
}, nodePty);

session.onData((chunk) => {
  process.stdout.write(chunk);
});

session.resize(100, 30);
session.write("echo hello\n");

For multi-viewport projection, use the adapter helper exported from this package:

import { createNodePtyAdaptiveTerminal } from "@aitty/node-pty";

const terminal = await createNodePtyAdaptiveTerminal({
  command: "zsh",
  cwd: process.cwd()
});

const mobile = terminal.attachViewport({ id: "mobile", cols: 39, rows: 24 });
const desktop = terminal.attachViewport({ id: "desktop", cols: 144, rows: 36 });