diff --git a/clients/vscode/CONTRIBUTING.md b/clients/vscode/CONTRIBUTING.md
new file mode 100644
index 000000000000..a658cc762bfa
--- /dev/null
+++ b/clients/vscode/CONTRIBUTING.md
@@ -0,0 +1,40 @@
+# CONTRIBUTING
+
+## Development
+
+Thank you for considering contributing to Tabby VSCode Extension, to get started, use the following commands:
+
+```bash
+
+# Install dependencies
+pnpm install
+
+# Start VSCode in development mode, with the extension loaded
+pnpm dev
+
+# Start VSCode Webview in development mode, with the extension loaded
+pnpm dev:browser
+```
+
+## Architecture
+
+On a high level the extension is divided into the following components:
+
+                            +---------------------+
+                            |     Tabby Server    |
+    +------------------+    | +-----------------+ |
+    | VSCode Extension | ---->|                 | |
+    +------------------+    | |     Chat UI     | |
+             |              | |                 | |
+             |              | +-----------------+ |
+             |              |                     |
+             v              | +-----------------+ |
+    +------------------+    | |                 | |
+    |   Tabby Agent    | ---->|       API       | |
+    +------------------+    | |                 | |
+                            | +-----------------+ |
+                            +---------------------+
+
+- **Tabby Server**: The server component of Tabby, responsible for managing user accounts, code completions, and chat functionality.
+- **Chat UI**: The web-based UI for Tabby Chat, which is embedded as a webview in the VSCode extension. It is distributed together with the Tabby Server.
+- **Tabby Agent**: The LSP server of Tabby, responsible for providing code completions and other language services to the VSCode extension. It communicates with the Tabby Server via the API. For VSCode, the Tabby Agent is a library, thus it is embedded in the extension.