diff --git a/docs/features/shell-integration.md b/docs/features/shell-integration.mdx
similarity index 98%
rename from docs/features/shell-integration.md
rename to docs/features/shell-integration.mdx
index 37d8b59d..58dc7c38 100644
--- a/docs/features/shell-integration.md
+++ b/docs/features/shell-integration.mdx
@@ -8,11 +8,31 @@ keywords:
   - troubleshooting
 image: /img/social-share.jpg
 ---
+import Codicon from '@site/src/components/Codicon';
 
 # Terminal Shell Integration
 
 Terminal Shell Integration is a key feature that enables Roo Code to execute commands in your terminal and intelligently process their output. This bidirectional communication between the AI and your development environment unlocks powerful automation capabilities.
 
+<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
+  <iframe
+    src="https://www.youtube.com/embed/rkWBHeG9A-4"
+    style={{
+      position: 'absolute',
+      top: 0,
+      left: 0,
+      width: '100%',
+      height: '100%',
+    }}
+    frameBorder="0"
+    allow="autoplay; encrypted-media"
+    allowFullScreen
+    title="Terminal Integration Tutorial"
+  ></iframe>
+</div>
+
+<br />
+
 ---
 
 ## What is Shell Integration?
diff --git a/docs/tutorial-videos.json b/docs/tutorial-videos.json
index 0fe580c0..dbc06baf 100644
--- a/docs/tutorial-videos.json
+++ b/docs/tutorial-videos.json
@@ -51,6 +51,10 @@
     {
       "id": "_Op3VfLPEu8",
       "title": "Code Actions"
+    },
+    {
+      "id": "rkWBHeG9A-4",
+      "title": "Terminal Integration"
     }
   ]
 }