diff --git a/README.md b/README.md
index 5be580f..eb5b1a9 100644
--- a/README.md
+++ b/README.md
@@ -19,6 +19,36 @@ logical database over gRPC, plus thin Document/Relational connect helpers.
 This package does **not** reference `Mishima.Nexus.Node.*` (the server host assemblies) — it only
 depends on the generated `Mishima.Nexus.Wire.V1` gRPC stubs, `Robotico.Graph`, and `Robotico.Time`.
 
+<!-- repo-uses:start -->
+## Uses
+
+This repository uses:
+
+```mermaid
+flowchart LR
+  robotico_nexus_client_csharp["robotico-nexus-client-csharp"]
+  mishima_nexus["mishima-nexus"]
+  robotico_nexus_client_csharp --> mishima_nexus
+```
+<!-- repo-uses:end -->
+
+<!-- repo-used-by:start -->
+## Used by
+
+This repository is used by:
+
+```mermaid
+flowchart LR
+  robotico_nexus_client_csharp["robotico-nexus-client-csharp"]
+  mishima_nexus["mishima-nexus"]
+  mishima_nexus_wpf["mishima-nexus-wpf"]
+  tanukiarmy_bot_ng["tanukiarmy-bot-ng"]
+  robotico_nexus_client_csharp --> mishima_nexus
+  robotico_nexus_client_csharp --> mishima_nexus_wpf
+  robotico_nexus_client_csharp --> tanukiarmy_bot_ng
+```
+<!-- repo-used-by:end -->
+
 ## Quick start
 
 ```csharp