diff --git a/apps/vscode/README.md b/apps/vscode/README.md
index 72387de8d7..fb339e6334 100644
--- a/apps/vscode/README.md
+++ b/apps/vscode/README.md
@@ -5,3 +5,26 @@ It is recommended to install the [VSCode talon extension pack](https://marketpla
 ## Cursorless
 
 If you'd like to use Cursorless, follow the instructions in the [cursorless-talon repo](https://github.com/pokey/cursorless-talon).
+
+## Terminal
+
+In order to use terminal commands when the VSCode terminal is focused, you must add the following line to your [VSCode `settings.json`](https://code.visualstudio.com/docs/getstarted/settings#_settingsjson):
+
+```
+"window.title": "${activeEditorShort}${separator}${rootName}${separator}${profileName}${separator}focus:[${focusedView}]",
+```
+
+This setting will cause VSCode to include a special string in the window title whenever the terminal is focused. Talon will look for this string in the window title and activate the terminal commands in response.
+
+Note that if you have customizations in your window title that you'd like to keep, the important part is just to ensure that `focus:[${focusedView}]` appears somewhere within your custom window title.
+
+In order to enable additional terminal commands you will need to set some tags when the terminal tag is active. You can do this by creating a file in your talon settings that looks something like this:
+
+```
+tag: terminal
+-
+tag(): user.generic_unix_shell
+tag(): user.git
+tag(): user.kubectl
+tag(): user.readline
+```
diff --git a/apps/vscode/vscode_terminal.talon b/apps/vscode/vscode_terminal.talon
new file mode 100644
index 0000000000..63caed5d43
--- /dev/null
+++ b/apps/vscode/vscode_terminal.talon
@@ -0,0 +1,7 @@
+app: vscode
+# Looks for special string in window title.
+# NOTE: This requires you to add a special setting to your VSCode settings.json
+# See [our vscode docs](./README.md#terminal)
+win.title: /focus:\[Terminal\]/
+-
+tag(): terminal