From a554f4ff2c3f4027126e880d129bd0ef1fffffcb Mon Sep 17 00:00:00 2001
From: Michael Shilman <michael@lab80.co>
Date: Sun, 14 Jul 2019 13:28:57 +0800
Subject: [PATCH] Update Codemod docs

---
 lib/codemod/README.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/lib/codemod/README.md b/lib/codemod/README.md
index f130f7d3b99..9686dd42d57 100644
--- a/lib/codemod/README.md
+++ b/lib/codemod/README.md
@@ -3,8 +3,26 @@
 Storybook Codemods is a collection of codemod scripts written with JSCodeshift.
 It will help you migrate breaking changes & deprecations.
 
+## CLI Integration
+
+The preferred way to run these codemods is via the CLI's `migrate` command.
+
+To get a list of available codemods:
+
+```
+npx -p @storybook/cli sb migrate --list
+```
+
+To run a codemod:
+
+```
+npx -p @storybook/cli sb migrate name-of-codemod --glob "**/*.stories.js"
+```
+
 ## Installation
 
+If you want to run these codemods by hand:
+
 ```sh
 yarn add jscodeshift @storybook/codemod --dev
 ```