diff --git a/README.md b/README.md
index a704fd6..3237dff 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,15 @@
 # shuma
 
-> An interactive shell with zsh/fish parity — multiplexer and remote sessions built in — in Rust, on [Llimphi](https://gitea.gioser.net/sergio/llimphi).
+> An interactive shell with zsh/fish parity — multiplexer and remote sessions built in — in Rust, on [Llimphi](https://github.com/tawasuyu/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.
 
+<p align="center">
+  <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">
+  <br>
+  <sub>a block-based terminal — sortable tables, collapsible output, detected sections, live streaming</sub>
+</p>
+
 ## Run
 
 ```sh
@@ -21,7 +27,7 @@ cargo run --release -p shuma-daemon          # session daemon (local + remote)
 
 ## 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`](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).
+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`](https://github.com/tawasuyu/tawasuyu) monorepo — the suite's source of truth. No vendoring, no duplication; the first build clones the monorepo (cached afterwards).
 
 ## Considerations
 
@@ -31,4 +37,4 @@ Clean front-door repo: it contains **only shuma's own crates**. Llimphi and ever
 
 ## License
 
-MIT. Builds on [Llimphi](https://gitea.gioser.net/sergio/llimphi) and the [gioser](https://gitea.gioser.net/sergio/gioser) suite.
+MIT. Builds on [Llimphi](https://github.com/tawasuyu/llimphi) and the [tawasuyu](https://github.com/tawasuyu/tawasuyu) suite.
diff --git a/docs/shuma_showreel.gif b/docs/shuma_showreel.gif
new file mode 100644
index 0000000..71013cb
Binary files /dev/null and b/docs/shuma_showreel.gif differ
diff --git a/docs/shuma_showreel.mp4 b/docs/shuma_showreel.mp4
new file mode 100644
index 0000000..98f57b3
Binary files /dev/null and b/docs/shuma_showreel.mp4 differ