scorpiox-multiplexer shell

Linux x64 Linux ARM64 macOS ARM64 Windows x64

Description

Built-in terminal multiplexer with split panes, PTY management, and session persistence. Run multiple terminal sessions side by side without leaving scorpiox-code.

scorpiox-multiplexer is a lightweight, native terminal multiplexer integrated directly into the scorpiox-code environment. Unlike tmux or screen, it requires no external installation — it ships as a single binary with built-in PTY allocation, pane splitting (horizontal and vertical), and session management.

  • Split terminal into multiple panes — horizontal and vertical layouts
  • Full PTY (pseudo-terminal) support for interactive programs
  • Session persistence — detach and reattach without losing state
  • Keyboard-driven navigation between panes
  • Lightweight C implementation (~2K lines) with minimal memory footprint
  • Integrated with scorpiox-code agent workflows for parallel task execution

Flags & Options

This tool operates as an integrated subsystem and does not expose standalone CLI flags. It is invoked internally by the scorpiox-code runtime when split-pane terminal sessions are requested.

Usage Examples

# Split the current terminal horizontally (top/bottom) scorpiox-multiplexer split -h # Split the current terminal vertically (left/right) scorpiox-multiplexer split -v
# Navigate between panes using direction keys scorpiox-multiplexer focus left scorpiox-multiplexer focus right scorpiox-multiplexer focus up scorpiox-multiplexer focus down
# Run a build in one pane while tailing logs in another scorpiox-multiplexer split -v # Left pane: make -j$(nproc) all # Right pane (focus right first): tail -f /var/log/build.log
# Create a 3-pane layout: editor + terminal + file watcher scorpiox-multiplexer split -v # split left/right scorpiox-multiplexer focus right scorpiox-multiplexer split -h # split right pane top/bottom # Now you have: # ┌──────────┬──────────┐ # │ │ term │ # │ editor ├──────────┤ # │ │ watch │ # └──────────┴──────────┘
# Detach from the current multiplexer session scorpiox-multiplexer detach # List existing sessions scorpiox-multiplexer list SESSION PANES CREATED dev-0 3 2026-05-29 09:14:02 build-1 2 2026-05-29 09:31:47 # Reattach to a named session scorpiox-multiplexer attach dev-0
# Close the active pane scorpiox-multiplexer close # Resize the current pane (grow right by 10 columns) scorpiox-multiplexer resize right 10 # Resize vertically (shrink by 5 rows) scorpiox-multiplexer resize down -5

Source & Build Info

Source File
scorpiox/scorpiox-multiplexer.c
Lines of Code
2,011
Dependencies
libsxterm, libsxutil
Platforms
4 targets

Related Tools