Metadata-Version: 2.4
Name: shellmux
Version: 0.1.2
Summary: shellmux — composition root powłoki dla ekosystemu willmux (SSOT: patrz docs/ARCHITECTURE.md)
Author-email: Tom Sapletta <tom@sapletta.com>
License-Expression: Apache-2.0
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE.notice
Requires-Dist: prompt-toolkit<4,>=3.0.52
Requires-Dist: pyte<0.9,>=0.8.2
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: goal>=2.1.0; python_version >= "3.12" and extra == "dev"
Requires-Dist: costs>=0.1.53; python_version >= "3.9" and extra == "dev"
Dynamic: license-file

# Shellmux


## AI Cost Tracking

![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.2-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
![AI Cost](https://img.shields.io/badge/AI%20Cost-$0.51-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-30.5h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)

- 🤖 **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](https://openrouter.ai/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](docs/ARCHITECTURE.md).

## Install and run

```sh
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](LICENSE) and provenance in [LICENSE.notice](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:

```sh
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.
