1# shuma
2
3> An interactive shell with zsh/fish parity — multiplexer and remote sessions built in — in Rust, on [Llimphi](https://gitea.gioser.net/sergio/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## Run
8
9```sh
10cargo run --release -p shuma-shell-llimphi # the GUI shell (Llimphi chassis)
11cargo run --release -p shuma-cli # CLI front-end
12cargo run --release -p shuma-daemon # session daemon (local + remote)
13```
14
15## Architecture
16
17- **`shuma-core`** — shell engine: parsing, history, completion, job control. UI-agnostic.
18- **`shuma-shell-llimphi`** — the GPU chassis (4 slots + Quake drawer + command bar + launcher modules).
19- **`shuma-protocol` / `shuma-remote-exec`** — local-client ↔ remote-server over TCP/TLS, no SSH daemon required.
20- **`matilda-*`** — declarative multi-host config (the bare-metal sibling).
21
22## How dependencies work
23
24Clean 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 [`gioser`](https://gitea.gioser.net/sergio/gioser) monorepo — the suite's source of truth. No vendoring, no duplication; the first build clones the monorepo (cached afterwards).
25
26## Considerations
27
28- **Replacement, not addition.** With shuma you can drop zsh/tmux/mosh — the behavior is covered.
29- Remote sessions use `shuma-protocol`, not an SSH daemon.
30- Cross-platform Llimphi UI; also runs inside the Wawa kernel.
31
32## License
33
34MIT. Builds on [Llimphi](https://gitea.gioser.net/sergio/llimphi) and the [gioser](https://gitea.gioser.net/sergio/gioser) suite.
README.md
shuma
An interactive shell with zsh/fish parity — multiplexer and remote sessions built in — in Rust, on Llimphi.
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.
Run
cargo run --release -p shuma-shell-llimphi # the GUI shell (Llimphi chassis)
cargo run --release -p shuma-cli # CLI front-end
cargo run --release -p shuma-daemon # session daemon (local + remote)
Architecture
shuma-core — shell engine: parsing, history, completion, job control. UI-agnostic.shuma-shell-llimphi — the GPU chassis (4 slots + Quake drawer + command bar + launcher modules).shuma-protocol / shuma-remote-exec — local-client ↔ remote-server over TCP/TLS, no SSH daemon required.matilda-* — declarative multi-host config (the bare-metal sibling).
How dependencies work
Clean 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 gioser monorepo — the suite's source of truth. No vendoring, no duplication; the first build clones the monorepo (cached afterwards).
Considerations
- Replacement, not addition. With shuma you can drop zsh/tmux/mosh — the behavior is covered.
- Remote sessions use
shuma-protocol, not an SSH daemon.
- Cross-platform Llimphi UI; also runs inside the Wawa kernel.
License
MIT. Builds on Llimphi and the gioser suite.