@truss-harness/tui 0.1.0 → 0.1.2

package/README.md

@@ -11,6 +11,10 @@ npm install -g @truss-harness/tui
 truss-tui
 ```
 
+Run `truss-tui --help` for a non-interactive launch reference. Inside the TUI, press `?` for the complete keyboard-control reference.
+
+On Windows, use PowerShell or Windows Terminal. When launching from Git Bash, Truss automatically uses Git for Windows' `winpty` bridge when available; `winpty truss-tui` is the manual fallback.
+
 The TUI reads the same `.truss-harness/config.json` profiles as `@truss-harness/cli`, or lets you select a detected Ollama, LM Studio, llama.cpp, or custom compatible endpoint at startup.
 
 Configured MCP stdio servers are connected when an Agent session starts, and their connection status appears in the Terminal pane. Plan mode loads only servers explicitly marked `readOnly`. Run `truss-cli config path` to locate the shared user and workspace configuration files.

package/dist/bin.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { execFile as execFileCallback } from "node:child_process";
 import { readdir, readFile } from "node:fs/promises";
 import { join, relative } from "node:path";
 import { cwd } from "node:process";
 import { promisify } from "node:util";
+import { fileURLToPath } from "node:url";
 import { Box, render, Text, useApp, useInput } from "ink";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { detectLocalEndpoints, listLocalModels } from "@truss-harness/provider-openai-compatible";
@@ -14,6 +15,38 @@ import { resolveConfiguration } from "@truss-harness/cli/config";
 import { createClientRuntime } from "@truss-harness/cli/runtime";
 import { executeWorkspaceCommand, FileWorkspacePlanStore, workspaceCommandHelp } from "@truss-harness/runtime";
 import { buildFileTree, fuzzyFiles, syntaxTokens, wrapSyntaxTokens } from "./file-browser.js";
+const tuiHelp = `${brand.productName} TUI
+
+Full-screen terminal workspace for local coding models.
+
+Usage:
+  ${brand.tuiCommand}
+
+The TUI starts in the current workspace and reads the same configuration
+profiles as ${brand.cliCommand}. Press ? inside the TUI for its complete
+keyboard-control reference.
+`;
+if (process.argv.slice(2).some((argument) => argument === "--help" || argument === "-h")) {
+    process.stdout.write(tuiHelp);
+    process.exit(0);
+}
+function ensureInteractiveTerminal() {
+    if (process.stdin.isTTY && typeof process.stdin.setRawMode === "function")
+        return;
+    // Git Bash exposes a pipe to Node for some console programs. winpty creates
+    // the Windows console bridge Ink needs for keyboard input.
+    if (process.platform === "win32" && process.env.MSYSTEM && process.env.TRUSS_TUI_WINPTY !== "1") {
+        const result = spawnSync("winpty", [process.execPath, fileURLToPath(import.meta.url), ...process.argv.slice(2)], {
+            stdio: "inherit",
+            env: { ...process.env, TRUSS_TUI_WINPTY: "1" }
+        });
+        if (!result.error)
+            process.exit(result.status ?? 1);
+    }
+    process.stderr.write(brand.productName + " TUI needs an interactive terminal with raw keyboard input. Open PowerShell or Windows Terminal and run " + brand.tuiCommand + ", or run winpty " + brand.tuiCommand + " from Git Bash.\n");
+    process.exit(1);
+}
+ensureInteractiveTerminal();
 const execFile = promisify(execFileCallback);
 const ignoredDirectories = new Set([".git", ".next", ".truss-harness", "node_modules", "dist", "coverage"]);
 const focusOrder = ["files", "editor", "chat", "terminal"];

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@truss-harness/tui",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Interactive terminal client for Truss.",
   "type": "module",
   "bin": {
-    "truss-tui": "./dist/bin.js"
+    "truss-tui": "dist/bin.js"
   },
   "scripts": {
     "build": "tsc -b",