1# shuma
2
3> An interactive shell with zsh/fish parity — multiplexer and remote sessions built in — in Rust, on [Llimphi](https://github.com/tawasuyu/llimphi).
4
5`shuma` replaces `zsh + tmux + mosh` with a single piece: a shell with history, completion and job-control, **native multiplexing** (no tmux), **remote sessions** (no mosh, no SSH daemon), all inside a Llimphi 4-slot chassis (TopBar · Main · BottomBar · Quake drawer). Optional `intent → command` inference layers an LLM on top — without it, the traditional shell runs unchanged. `matilda` is the sibling tool for declarative multi-host configuration.
6
7<p align="center">
8  <img src="docs/shuma_showreel.gif" alt="shuma showreel — a block-based terminal: a sortable ls -l table, collapsible ls -R sub-blocks, git status sections, a folded git log, and a live-streaming cargo build" width="900">
9  <br>
10  <sub>a block-based terminal — sortable tables, collapsible output, detected sections, live streaming</sub>
11</p>
12
13## Run
14
15```sh
16cargo run --release -p shuma-shell-llimphi   # the GUI shell (Llimphi chassis)
17cargo run --release -p shuma-cli             # CLI front-end
18cargo run --release -p shuma-daemon          # session daemon (local + remote)
19```
20
21## Architecture
22
23- **`shuma-core`** — shell engine: parsing, history, completion, job control. UI-agnostic.
24- **`shuma-shell-llimphi`** — the GPU chassis (4 slots + Quake drawer + command bar + launcher modules).
25- **`shuma-protocol` / `shuma-remote-exec`** — local-client ↔ remote-server over TCP/TLS, no SSH daemon required.
26- **`matilda-*`** — declarative multi-host config (the bare-metal sibling).
27
28## How dependencies work
29
30Clean front-door repo: it contains **only shuma's own crates**. Llimphi and every foundational dependency (content-addressed cards, P2P discovery via `chasqui`/`minga`, the `pata` panel host, `arje` process primitives, shared leaves) are pulled as git dependencies from the [`tawasuyu`](https://github.com/tawasuyu/tawasuyu) monorepo — the suite's source of truth. No vendoring, no duplication; the first build clones the monorepo (cached afterwards).
31
32## Considerations
33
34- **Replacement, not addition.** With shuma you can drop zsh/tmux/mosh — the behavior is covered.
35- Remote sessions use `shuma-protocol`, not an SSH daemon.
36- Cross-platform Llimphi UI; also runs inside the Wawa kernel.
37
38## License
39
40MIT. Builds on [Llimphi](https://github.com/tawasuyu/llimphi) and the [tawasuyu](https://github.com/tawasuyu/tawasuyu) suite.