Skip to main content

Shellmux

AI Cost Tracking

PyPI Version Python License AI Cost Human Time Model

  • 🤖 LLM usage: $0.5074 (67 commits)
  • 👤 Human dev: ~$3054 (30.5h @ $100/h, 30min dedup)

Generated on 2026-10-24 using openrouter/qwen/qwen3-coder-next


Shellmux is an ASCII terminal workspace for the Willmux ecosystem. It owns PTY panes, layouts and terminal controls. Heyasa owns speech recognition, synthesis, assistant routing and media commands. The package ownership map is documented in docs/ARCHITECTURE.md.

Install and run

python -m pip install -e .
shellmux --layout grid
shellmux --layout grid --assistant voice
shellmux --layout carousel --assistant media
shellmux map
shellmux --version

The terminal requires POSIX PTYs; use WSL on Windows. Install Heyasa with its audio support and make heyasa available on PATH. Voice/media presets use its existing console with confirmation enabled. /listen once captures one voice command; /audio status reports audio readiness.

Press Ctrl-B, then h for Heyasa voice, v for media, ? for help, g for grid, c for columns, r for rows, m for main, s for stage or a for carousel. Use 1..9 to focus a pane, n to add one, and q twice to quit. Layout changes keep running shell processes. Terminal borders default to straight Unicode lines in a fixed Heyasa palette; ASCII and monochrome fallbacks remain available. Pane output preserves VT styles.

Source and license

The extracted terminal code retains the original proprietary license in LICENSE and provenance in LICENSE.notice. Runtime libraries are separate dependencies. Willmux forwarding is delivered through its owning repository; this package does not start a Willmux web server.

UI profiles and shell configuration

The status line shows the actual Shellmux package version and the selected UI profile version. Profiles are owned by Shellmux; LLM routes remain owned by SubLLM. Selection uses an explicit catalogue and validates installed versions:

shellmux profiles
shellmux use heyasa-dark@1.0.0
shellmux config show
shellmux config set layout main
shellmux config set panes 3
shellmux config set color_depth truecolor
shellmux --require-version 0.1.0

heyasa-dark, heyasa-light and classic are installed profiles. Selecting a version never installs or downgrades a package. Configuration lives in $XDG_CONFIG_HOME/shellmux/ui.json (default ~/.config/shellmux/ui.json), or %APPDATA%/shellmux/ui.json for metadata/configuration on Windows. Override the file with SHELLMUX_CONFIG_FILE. CLI options override SHELLMUX_PROFILE, SHELLMUX_LAYOUT, SHELLMUX_PANES, SHELLMUX_BORDERS, SHELLMUX_COLOR_DEPTH and SHELLMUX_REQUIRE_VERSION, which override saved settings. Explicit layout and pane options keep their existing behavior. --borders ascii selects the legacy frame; NO_COLOR requests monochrome. Truecolor preserves exact theme RGB values; 256/16-color outputs use their available approximation. UTF-8 outputs use Unicode frames automatically; restricted encodings use ASCII. PTY workspace execution still requires POSIX or WSL.

From the Heyasa shell, /ui list, /ui use heyasa-dark@1.0.0 and /ui config set layout main use this same catalogue and configuration. tui opens the selected terminal workspace; gui opens the existing Willmux HUD.

Ctrl-B p selects and saves the next UI profile. Ctrl-B u reloads appearance from the configuration without closing or restarting running panes. Layout and pane-count defaults apply on the next workspace launch.

License

Licensed under Apache-2.0.

Metadata

Release files for shellmux 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for shellmux 0.1.2
File Size Uploaded Provenance Actions
shellmux-0.1.2.tar.gz 40.1 kB Without provenance Details for shellmux-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for shellmux 0.1.2
File Interpreter ABI Platform Actions
shellmux-0.1.2-py3-none-any.whl Python 3 none any Details for shellmux-0.1.2-py3-none-any.whl

Total release size: 83.1 kB

Release files / shellmux-0.1.2.tar.gz

Download URL shellmux-0.1.2.tar.gz
Size 40.1 kB
Tags Source
SHA-256 checksum
How to use checksums
92a6d8f0afe6342385da99c28cc7af874ee0d530a55c3bab4a00aa1906a89848
BLAKE2b-256 checksum
How to use checksums
0f40008f6f6b861bca915cbb17e18b1b6a8de23c856031e47e761a312a0af813
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.7

Release files / shellmux-0.1.2-py3-none-any.whl

Download URL shellmux-0.1.2-py3-none-any.whl
Size 43.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3201fffc4ddc4db08b161c8061ef1d7939d003f61b0c1eddb1b67899c9b2ced0
BLAKE2b-256 checksum
How to use checksums
834bff09954e54d0a8a9a9924e348c3f35ff765772f466b2b55cd3148b890816
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.7

Security for shellmux 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page