Client-side Fabric mod (Minecraft 26.3, Fabric Loader 0.19.5, Java 25). It mirrors and drives your nodeterm tmux sessions from inside the game, and shows agent status on the HUD. It needs no Fabric API.
- Sneak + right-click any block with an empty main hand to open the session picker. Sessions that need you (blocked or waiting) come first, then finished-but-unseen ones, then everything else by most recent activity. Tabs along the top filter by nodeterm project, matched by the session's working directory. Each tab shows a color swatch, a count and a red dot when something needs you, and the selected tab is remembered while the game runs. Click a row to open it.
- In the terminal: type normally. Enter, Backspace, Tab, Shift+Tab, the arrow keys, Home, End, PgUp, PgDn, Delete and Ctrl+letter all work. Cmd+V pastes as a bracketed paste, so a multi-line paste doesn't run each line.
- Esc closes the screen. Shift+Esc sends Escape to the terminal.
- Both screens look like a vanilla container (chest or enchanting table): the world dims behind a gray panel, and the chest open and close sounds play. The game keeps running underneath.
- The pane is never resized. It renders at whatever size nodeterm gave it.
- Agent HUD: a capsule at the top center of the screen shows red/amber for agents that need you, blue for working ones and green for finished-but-unseen ones. It moves below any boss bars, hides when every count is zero, and hides with F1.
tmux -L node-terminal(it uses nodeterm.app's bundled tmux, which started the live server, then /opt/homebrew/bin/tmux, then PATH).~/Library/Application Support/node-terminal/agent-status.json, polled once a second.~/Library/Application Support/node-terminal/workspace.json, for project tabs.
Gradle must run on JDK 25. The Minecraft launcher ships one:
JAVA_HOME="$HOME/Library/Application Support/minecraft/runtime/java-runtime-epsilon/mac-os-arm64/java-runtime-epsilon/jre.bundle/Contents/Home" ./gradlew build
The jar is build/libs/nodeterm-mc-0.1.0.jar; copy it into ~/Library/Application Support/minecraft/mods/.
./gradlew liveCheck lists and captures a live session without sending any keys.