numux 1.4.0 → 1.5.0

package/README.md

@@ -264,7 +264,7 @@ Persistent processes that crash are auto-restarted with exponential backoff (1s
 | `Alt+L` | Clear active pane output |
 | `Alt+1`–`Alt+9` | Jump to tab |
 | `Alt+Left/Right` | Cycle tabs |
-| `Up/Down` | Scroll output 1 line (non-interactive panes) |
+| `Up/Down` | Navigate between tabs |
 | `PageUp/PageDown` | Scroll output by page (non-interactive panes) |
 | `Home/End` | Scroll to top/bottom (non-interactive panes) |
 | `Alt+PageUp/PageDown` | Scroll output up/down |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "numux",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Terminal multiplexer with dependency orchestration",
   "type": "module",
   "license": "MIT",
@@ -27,7 +27,7 @@
     ".": "./src/config.ts"
   },
   "scripts": {
-    "dev": "bun run src/index.ts",
+    "dev": "cd example && bun run dev --debug",
     "test": "bun test",
     "typecheck": "bunx tsc --noEmit",
     "lint": "biome check .",

package/src/ui/app.ts

@@ -2,6 +2,7 @@ import { BoxRenderable, type CliRenderer, createCliRenderer } from '@opentui/cor
 import type { ProcessManager } from '../process/manager'
 import type { ResolvedNumuxConfig } from '../types'
 import { buildProcessHexColorMap } from '../utils/color'
+import { log } from '../utils/logger'
 import { Pane, type SearchMatch } from './pane'
 import { StatusBar } from './status-bar'
 import { TabBar } from './tabs'
@@ -149,6 +150,8 @@ export class App {
 		this.renderer.keyInput.on(
 			'keypress',
 			(key: { ctrl: boolean; shift: boolean; meta: boolean; name: string; sequence: string }) => {
+				log(key)
+
 				// Ctrl+C: quit (always works)
 				if (key.ctrl && key.name === 'c') {
 					if (this.searchMode) {
@@ -167,30 +170,34 @@ export class App {
 					return
 				}
 
-				// Alt+Shift combos
-				if (key.meta && key.shift && !key.ctrl) {
-					// Alt+Shift+R: restart all processes
-					if (key.name === 'r') {
+				if (!this.activePane) return
+
+				const isInteractive = this.config.processes[this.activePane]?.interactive === true
+
+				// Non-interactive panes: plain keys act as shortcuts
+				if (!isInteractive) {
+					const name = key.name.toLowerCase()
+
+					// Shift+R: restart all processes
+					if (key.shift && name === 'r') {
 						this.manager.restartAll(this.termCols, this.termRows)
 						return
 					}
-				}
 
-				if (key.meta && !key.ctrl && !key.shift) {
-					// Alt+F: enter search mode
-					if (key.name === 'f' && this.activePane) {
+					// F: enter search mode
+					if (name === 'f') {
 						this.enterSearch()
 						return
 					}
 
-					// Alt+R: restart active process
-					if (key.name === 'r' && this.activePane) {
+					// R: restart active process
+					if (name === 'r') {
 						this.manager.restart(this.activePane, this.termCols, this.termRows)
 						return
 					}
 
-					// Alt+S: stop/start active process
-					if (key.name === 's' && this.activePane) {
+					// S: stop/start active process
+					if (name === 's') {
 						const state = this.manager.getState(this.activePane)
 						if (state?.status === 'stopped' || state?.status === 'finished' || state?.status === 'failed') {
 							this.manager.start(this.activePane, this.termCols, this.termRows)
@@ -200,80 +207,61 @@ export class App {
 						return
 					}
 
-					// Alt+L: clear active pane
-					if (key.name === 'l' && this.activePane) {
+					// L: clear active pane
+					if (name === 'l') {
 						this.panes.get(this.activePane)?.clear()
 						return
 					}
 
-					// Alt+1-9: jump to tab (uses display order from tab bar)
-					const num = Number.parseInt(key.name, 10)
+					// 1-9: jump to tab (uses display order from tab bar)
+					const num = Number.parseInt(name, 10)
 					if (num >= 1 && num <= 9 && num <= this.tabBar.count) {
 						this.tabBar.setSelectedIndex(num - 1)
 						this.switchPane(this.tabBar.getNameAtIndex(num - 1))
 						return
 					}
 
-					// Alt+Left/Right: cycle tabs
-					if (key.name === 'left' || key.name === 'right') {
+					// Left/Right: cycle tabs
+					if (name === 'left' || name === 'right') {
 						const current = this.tabBar.getSelectedIndex()
 						const count = this.tabBar.count
-						const next = key.name === 'right' ? (current + 1) % count : (current - 1 + count) % count
+						const next = name === 'right' ? (current + 1) % count : (current - 1 + count) % count
 						this.tabBar.setSelectedIndex(next)
 						this.switchPane(this.tabBar.getNameAtIndex(next))
 						return
 					}
 
-					// Alt+PageUp/PageDown: scroll output
-					if (this.activePane && (key.name === 'pageup' || key.name === 'pagedown')) {
+					// PageUp/PageDown: scroll by page
+					if (name === 'pageup' || name === 'pagedown') {
 						const pane = this.panes.get(this.activePane)
 						const delta = this.termRows - 2
-						pane?.scrollBy(key.name === 'pageup' ? -delta : delta)
+						pane?.scrollBy(name === 'pageup' ? -delta : delta)
 						return
 					}
 
-					// Alt+Home/End: scroll to top/bottom
-					if (this.activePane && key.name === 'home') {
+					// Home/End: scroll to top/bottom
+					if (name === 'home') {
 						this.panes.get(this.activePane)?.scrollToTop()
 						return
 					}
-					if (this.activePane && key.name === 'end') {
+					if (name === 'end') {
 						this.panes.get(this.activePane)?.scrollToBottom()
 						return
 					}
-				}
-
-				if (!this.activePane) return
-
-				const isInteractive = this.config.processes[this.activePane]?.interactive === true
-
-				// Non-interactive panes: arrow keys scroll, all other input is dropped
-				if (!isInteractive) {
-					if (key.name === 'up' || key.name === 'down') {
-						const pane = this.panes.get(this.activePane)
-						pane?.scrollBy(key.name === 'up' ? -1 : 1)
-					} else if (key.name === 'pageup' || key.name === 'pagedown') {
-						const pane = this.panes.get(this.activePane)
-						const delta = this.termRows - 2
-						pane?.scrollBy(key.name === 'pageup' ? -delta : delta)
-					} else if (key.name === 'home') {
-						this.panes.get(this.activePane)?.scrollToTop()
-					} else if (key.name === 'end') {
-						this.panes.get(this.activePane)?.scrollToBottom()
-					}
 					return
 				}
 
-				// Forward all other input to the active process
+				// Forward all other input to the active process (interactive mode)
 				if (key.sequence) {
 					this.manager.write(this.activePane, key.sequence)
 				}
 			}
 		)
 
-		// Show first pane
+		// Show first pane and focus sidebar for keyboard navigation
 		if (this.names.length > 0) {
 			this.switchPane(this.names[0])
+			this.tabBar.focus()
 		}
 
 		// Start all processes

package/src/ui/status-bar.ts

@@ -34,7 +34,9 @@ export class StatusBar {
 		if (this._searchMode) {
 			return this.buildSearchContent()
 		}
-		return new StyledText([plain('')])
+		return new StyledText([
+			plain('\u2190\u2192/1-9: tabs  R: restart  S: stop/start  F: search  L: clear  Ctrl+C: quit')
+		])
 	}
 
 	private buildSearchContent(): StyledText {

package/src/utils/logger.ts

@@ -3,6 +3,7 @@ import { resolve } from 'node:path'
 
 let enabled = false
 let logFile = ''
+let debugCallback: ((line: string) => void) | null = null
 
 export function enableDebugLog(dir?: string): void {
 	const logDir = dir ?? resolve(process.cwd(), '.numux')
@@ -13,12 +14,18 @@ export function enableDebugLog(dir?: string): void {
 	enabled = true
 }
 
-export function log(message: string, ...args: unknown[]): void {
+export function setDebugCallback(cb: ((line: string) => void) | null): void {
+	debugCallback = cb
+}
+export function log(...args: unknown[]): void {
 	if (!enabled) return
 	try {
 		const timestamp = new Date().toISOString()
-		const formatted = args.length > 0 ? `${message} ${args.map(a => JSON.stringify(a)).join(' ')}` : message
-		appendFileSync(logFile, `[${timestamp}] ${formatted}\n`)
+		const formatted =
+			args.length > 0 ? `${args.map(a => (typeof a === 'string' ? a : JSON.stringify(a))).join(' ')}` : ''
+		const line = `[${timestamp}] ${formatted}`
+		appendFileSync(logFile, `${line}\n`)
+		debugCallback?.(line)
 	} catch {
 		// Disk errors in debug logging should not crash the app
 		enabled = false
@@ -29,4 +36,5 @@ export function log(message: string, ...args: unknown[]): void {
 export function _resetLogger(): void {
 	enabled = false
 	logFile = ''
+	debugCallback = null
 }