diff --git a/genkit-tools/cli/README.md b/genkit-tools/cli/README.md
index 6abfb6f89b..a22da2f884 100644
--- a/genkit-tools/cli/README.md
+++ b/genkit-tools/cli/README.md
@@ -1,17 +1,51 @@
-Genkit CLI.
+# Firebase Genkit CLI
 
-Right now this is just scaffolding. To build,
+The package contains the CLI for Firebase Genkit, an open source framework with rich local tooling to help app developers build, test, deploy, and monitor AI-powered features for their apps with confidence. Genkit is built by Firebase, Google's app development platform that is trusted by millions of businesses around the world.
 
+Review the [documentation](https://firebase.google.com/docs/genkit) for details and samples.
+
+To install the CLI:
+
+```bash
+npm i -g genkit
 ```
-pnpm i
-pnpm build
-```
 
-After executing `npm link`, the `genkit` binary will be in your local path.
-Call `genkit example` to see the example.
+Available commands:
+
+- `init [options]`
+
+  initialize a project directory with Genkit
+
+- `start [options]`
+
+  run the app in dev mode and start a Developer UI
+
+- `flow:run [options] <flowName> [data]`
+
+  run a flow using provided data as input
+
+- `flow:batchRun [options] <flowName> <inputFileName>`
+
+  batch run a flow using provided set of data from a file as input
+
+- `flow:resume <flowName> <flowId> <data>`
+
+  resume an interrupted flow (experimental)
+
+- `eval:extractData [options] <flowName>`
+
+  extract evaludation data for a given flow from the trace store
+
+- `eval:run [options] <dataset>`
+
+  evaluate provided dataset against configured evaluators
+
+- `eval:flow [options] <flowName> [data]`
+
+  evaluate a flow against configured evaluators using provided data as input
+
+- `config`
+
+  set development environment configuration
 
-We're following a slightly different architecture from Firebase Tools. For
-commands, Firebase Tools relies on node `require()` calls to dynamically load
-code. This is discouraged (in fact, disabled per our TSLint) so instead
-all files (and thus all commands) need to be directly referenced from something
-in the tree of imports. See `src/cli.ts`.
+- `help`