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 tawasuyu 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.