diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
new file mode 100644
index 0000000..9e9e50b
--- /dev/null
+++ b/docs/troubleshooting.md
@@ -0,0 +1,13 @@
+# Troubleshooting
+
+## Worktree shows as prunable
+
+The directory was deleted without `git worktree remove`. Run `git worktree prune` or use the prune action in gwt.
+
+## Locked worktree cannot be removed
+
+Run `git worktree unlock <path>` first, or check the lock reason with `git worktree list --porcelain`.
+
+## Shell does not change directory after selecting a worktree
+
+Make sure the shell integration is installed, see README section "Shell integration".