feat(up): add --limit option to limit the number of migrations to run

packages/cli/README.md

@@ -20,6 +20,35 @@ bun add @emigrate/cli
 
 ## Usage
 
+```text
+Usage: emigrate up [options]
+
+Run all pending migrations
+
+Options:
+
+  -h, --help              Show this help message and exit
+  -d, --directory <path>  The directory where the migration files are located (required)
+  -i, --import <module>   Additional modules/packages to import before running the migrations (can be specified multiple times)
+                          For example if you want to use Dotenv to load environment variables or when using TypeScript
+  -s, --storage <name>    The storage to use for where to store the migration history (required)
+  -p, --plugin <name>     The plugin(s) to use (can be specified multiple times)
+  -r, --reporter <name>   The reporter to use for reporting the migration progress
+  -l, --limit <count>     Limit the number of migrations to run
+  --dry                   List the pending migrations that would be run without actually running them
+  --color                 Force color output (this option is passed to the reporter)
+  --no-color              Disable color output (this option is passed to the reporter)
+
+Examples:
+
+  emigrate up --directory src/migrations -s fs
+  emigrate up -d ./migrations --storage @emigrate/mysql
+  emigrate up -d src/migrations -s postgres -r json --dry
+  emigrate up -d ./migrations -s mysql --import dotenv/config
+```
+
+### Examples
+
 Create a new migration:
 
 ```bash