Shellmux
AI Cost Tracking
- 🤖 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.