diff --git a/README.md b/README.md
index b7433b9..5f39588 100644
--- a/README.md
+++ b/README.md
@@ -5,9 +5,11 @@
 <h1 align="center">PinchChat</h1>
 
 [![CI](https://github.com/MarlBurroW/pinchchat/actions/workflows/ci.yml/badge.svg)](https://github.com/MarlBurroW/pinchchat/actions/workflows/ci.yml)
+[![GitHub Release](https://img.shields.io/github/v/release/MarlBurroW/pinchchat?color=cyan)](https://github.com/MarlBurroW/pinchchat/releases)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/)
 [![Docker](https://img.shields.io/badge/docker-ghcr.io-blue)](https://github.com/MarlBurroW/pinchchat/pkgs/container/pinchchat)
+[![GitHub Stars](https://img.shields.io/github/stars/MarlBurroW/pinchchat?style=social)](https://github.com/MarlBurroW/pinchchat)
 [![Website](https://img.shields.io/badge/website-GitHub%20Pages-blueviolet)](https://marlburrow.github.io/pinchchat/)
 
 **A sleek, dark-themed webchat UI for [OpenClaw](https://github.com/openclaw/openclaw) — monitor sessions, stream responses, and inspect tool calls in real-time.**
@@ -161,6 +163,19 @@ export const localeLabels: Record<string, string> = {
 
 > **Tip:** TypeScript enforces that your new locale object has the same keys as `en` — missing translations won't compile.
 
+## ⌨️ Keyboard Shortcuts
+
+Press **?** anywhere to open the shortcuts panel.
+
+| Shortcut | Action |
+|---|---|
+| `Enter` | Send message |
+| `Shift + Enter` | New line |
+| `Esc` | Stop generation / close sidebar |
+| `Ctrl/⌘ + K` | Focus session search |
+| `Alt + ↑` / `Alt + ↓` | Switch between sessions |
+| `?` | Show shortcuts help |
+
 ## ❓ Troubleshooting
 
 ### Connection fails / "WebSocket error"
diff --git a/docs/index.html b/docs/index.html
index 69be117..536c8aa 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -747,6 +747,13 @@
 
       <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 1rem; margin-top: 2rem;">
 
+        <div style="background: rgba(255,255,255,0.03); border: 1px solid rgba(255,255,255,0.06); border-radius: 12px; padding: 1.25rem;">
+          <div style="font-size: 1.5rem; margin-bottom: 0.5rem;">⌨️</div>
+          <h3 style="color: var(--text-primary); font-size: 0.95rem; margin-bottom: 0.35rem;">Keyboard Shortcuts</h3>
+          <p style="color: var(--text-secondary); font-size: 0.82rem; line-height: 1.5;">Navigate between sessions with Alt+↑/↓, search with ⌘K, and view all shortcuts with ?. Power-user friendly.</p>
+          <span style="display: inline-block; margin-top: 0.5rem; font-size: 0.7rem; color: var(--cyan); opacity: 0.7;">v1.13</span>
+        </div>
+
         <div style="background: rgba(255,255,255,0.03); border: 1px solid rgba(255,255,255,0.06); border-radius: 12px; padding: 1.25rem;">
           <div style="font-size: 1.5rem; margin-bottom: 0.5rem;">📥</div>
           <h3 style="color: var(--text-primary); font-size: 0.95rem; margin-bottom: 0.35rem;">Conversation Export</h3>