diff --git a/README.md b/README.md
index 3d9dc97..74a9793 100644
--- a/README.md
+++ b/README.md
@@ -4,8 +4,14 @@
 
 `khipu` (Quechua: *knotted-cord record*) is a sovereign note system: local-first, content-addressed, synced peer-to-peer over the `card`/`chasqui` layer (LAN + WAN + relay/NAT traversal, UDP & DHT discovery, encrypted identity). Notes are designed to be let go of as much as kept — a record that forgets on purpose.
 
+<p align="center">
+  <img src="docs/khipu_showreel.gif" alt="khipu showreel — a canvas of notes as a constellation, sized by mass, clustered by attention, with affinity filaments" width="900">
+  <br>
+  <sub>the canvas that orders the chaos by attention — notes as a living constellation</sub>
+</p>
+
 ## How dependencies work
-Front-door repo: only `khipu-*` crates here. Identity (`card`), networking (`chasqui`) and shared leaves are git-dependencies of the [`gioser`](https://gitea.gioser.net/sergio/gioser) monorepo.
+Front-door repo: only `khipu-*` crates here. Identity (`card`), networking (`chasqui`) and shared leaves are git-dependencies of the [`tawasuyu`](https://github.com/tawasuyu/tawasuyu) monorepo.
 
 ## License
-MIT. Part of the [gioser](https://gitea.gioser.net/sergio/gioser) suite.
+MIT. Part of the [tawasuyu](https://github.com/tawasuyu/tawasuyu) suite.
diff --git a/docs/khipu_showreel.gif b/docs/khipu_showreel.gif
new file mode 100644
index 0000000..5cb103a
Binary files /dev/null and b/docs/khipu_showreel.gif differ
diff --git a/docs/khipu_showreel.mp4 b/docs/khipu_showreel.mp4
new file mode 100644
index 0000000..7327892
Binary files /dev/null and b/docs/khipu_showreel.mp4 differ