@wooksjs/event-cli 0.6.6 → 0.7.0

package/README.md

@@ -1,7 +1,5 @@
 # @wooksjs/event-cli
 
-**!!! This is work-in-progress library, breaking changes are expected !!!**
-
 <p align="center">
 <img src="../../wooks-logo.png" width="450px"><br>
 <a  href="https://github.com/wooksjs/wooksjs/blob/main/LICENSE">
@@ -9,41 +7,17 @@
 </a>
 </p>
 
-As a part of `wooks` event processing framework, `@wooksjs/event-cli` implements CLI events and provides composables that let you:
-
-- access flags (- or --)
+CLI event processing for the Wooks framework. Build command-line applications with composable functions for flags, arguments, and auto-generated help.
 
 ## Installation
 
-`npm install wooks @wooksjs/event-cli`
-
-## Quick Start
-
-```js
-import { useRouteParams } from 'wooks'
-import { createCliApp, useCliOptions } from '@wooksjs/event-cli'
-
-const app = createCliApp()
-
-app.cli('test', () => {
-  console.log('options:')
-  return useCliOptions()
-})
-
-app.cli(':arg', () => {
-  console.log('run argument:', useRouteParams().params)
-  return 'done'
-})
-
-app.run()
-
-// node ./index.js test
-// node ./index.js random
+```sh
+npm install @wooksjs/event-cli
 ```
 
 ## Documentation
 
-To check out docs, visit [wooks.moost.org](https://wooks.moost.org/cliapp/).
+For full documentation, visit [wooks.moost.org/cliapp](https://wooks.moost.org/cliapp/).
 
 ## AI Agent Skills
 
@@ -51,10 +25,10 @@ This package ships with structured skill files for AI coding agents (Claude Code
 
 ```bash
 # Project-local (recommended — version-locked, commits with your repo)
-npx @wooksjs/event-cli setup-skills
+npx wooksjs-event-cli-skill
 
 # Global (available across all your projects)
-npx @wooksjs/event-cli setup-skills --global
+npx wooksjs-event-cli-skill --global
 ```
 
 To keep skills automatically up-to-date, add a postinstall script to your `package.json`:
@@ -62,9 +36,11 @@ To keep skills automatically up-to-date, add a postinstall script to your `packa
 ```json
 {
   "scripts": {
-    "postinstall": "npx @wooksjs/event-cli setup-skills --postinstall"
+    "postinstall": "wooksjs-event-cli-skill --postinstall"
   }
 }
 ```
 
-This ensures the skill files are refreshed whenever dependencies are installed, without needing a separate command.
+## License
+
+MIT

package/dist/index.cjs

@@ -6,11 +6,11 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key$1; i < n; i++) {
+		key$1 = keys[i];
+		if (!__hasOwnProp.call(to, key$1) && key$1 !== except) __defProp(to, key$1, {
+			get: ((k) => from[k]).bind(null, key$1),
+			enumerable: !(desc = __getOwnPropDesc(from, key$1)) || desc.enumerable
 		});
 	}
 	return to;
@@ -22,28 +22,32 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 //#endregion
 const __prostojs_cli_help = __toESM(require("@prostojs/cli-help"));
+const __wooksjs_event_core = __toESM(require("@wooksjs/event-core"));
 const minimist = __toESM(require("minimist"));
 const wooks = __toESM(require("wooks"));
-const __wooksjs_event_core = __toESM(require("@wooksjs/event-core"));
 
+//#region packages/event-cli/src/cli-kind.ts
+const cliKind = (0, __wooksjs_event_core.defineEventKind)("CLI", {
+	argv: (0, __wooksjs_event_core.slot)(),
+	pathParams: (0, __wooksjs_event_core.slot)(),
+	command: (0, __wooksjs_event_core.slot)(),
+	opts: (0, __wooksjs_event_core.slot)(),
+	cliHelp: (0, __wooksjs_event_core.slot)()
+});
+const flagsKey = (0, __wooksjs_event_core.key)("cli.flags");
+
+//#endregion
 //#region packages/event-cli/src/event-cli.ts
-/** Creates a new async event context for a CLI command invocation. */
+/** Creates a new event context for a CLI command invocation. */
 function createCliContext(data, options) {
-	return (0, __wooksjs_event_core.createAsyncEventContext)({
-		event: {
-			...data,
-			type: "CLI"
-		},
-		options
-	});
-}
-/**
-* Wrapper on top of useEventContext that provides
-* proper context types for CLI event
-* @returns set of hooks { getCtx, restoreCtx, clearCtx, hookStore, getStore, setStore }
-*/
-function useCliContext() {
-	return (0, __wooksjs_event_core.useAsyncEventContext)("CLI");
+	const ctx = new __wooksjs_event_core.EventContext(options);
+	return (fn) => (0, __wooksjs_event_core.run)(ctx, () => ctx.seed(cliKind, {
+		argv: data.argv,
+		pathParams: data.pathParams,
+		command: data.command,
+		opts: data.opts,
+		cliHelp: data.cliHelp
+	}, fn));
 }
 
 //#endregion
@@ -161,13 +165,13 @@ var WooksCli = class extends wooks.WooksAdapterBase {
 			pathParams,
 			cliHelp: this.cliHelp,
 			command: path.replace(/\//gu, " ").trim()
-		}, this.mergeEventOptions(this.opts?.eventOptions));
+		}, this.getEventContextOptions());
 		return runInContext(async () => {
-			const { store } = useCliContext();
-			store("flags").value = parsedFlags;
+			const ctx = (0, __wooksjs_event_core.current)();
+			ctx.set(flagsKey, parsedFlags);
 			this.computeAliases();
 			const { handlers: foundHandlers, firstStatic } = this.wooks.lookup("CLI", path);
-			if (typeof firstStatic === "string") store("event").set("command", firstStatic.replace(/\//gu, " ").trim());
+			if (typeof firstStatic === "string") ctx.set(cliKind.keys.command, firstStatic.replace(/\//gu, " ").trim());
 			const handlers = foundHandlers || this.opts?.onNotFound && [this.opts.onNotFound] || null;
 			if (handlers) try {
 				for (const handler of handlers) {
@@ -239,13 +243,13 @@ function createCliApp(opts, wooks$1) {
 * @returns an object with CLI options
 */
 function useCliOptions() {
-	const { store } = useCliContext();
-	const flags = store("flags");
-	if (!flags.value) {
-		const event = store("event");
-		flags.value = (0, minimist.default)(event.get("argv"), event.get("opts"));
+	const ctx = (0, __wooksjs_event_core.current)();
+	if (!ctx.has(flagsKey)) {
+		const argv = ctx.get(cliKind.keys.argv);
+		const opts = ctx.get(cliKind.keys.opts);
+		ctx.set(flagsKey, (0, minimist.default)(argv, opts));
 	}
-	return flags.value;
+	return ctx.get(flagsKey);
 }
 /**
 * Getter for Cli Option value
@@ -265,7 +269,7 @@ function useCliOption(name) {
 		const options = useCliHelp().getEntry().options || [];
 		const opt = options.find((o) => o.keys.includes(name));
 		if (opt) {
-			for (const key of opt.keys) if (useCliOptions()[key]) return useCliOptions()[key];
+			for (const key$1 of opt.keys) if (useCliOptions()[key$1]) return useCliOptions()[key$1];
 		}
 	} catch {}
 	return useCliOptions()[name];
@@ -287,15 +291,15 @@ function useCliOption(name) {
 * @returns
 */
 function useCliHelp() {
-	const event = useCliContext().store("event");
-	const getCliHelp = () => event.get("cliHelp");
-	const getEntry = () => getCliHelp().match(event.get("command")).main;
+	const ctx = (0, __wooksjs_event_core.current)();
+	const getCliHelp = () => ctx.get(cliKind.keys.cliHelp);
+	const getEntry = () => getCliHelp().match(ctx.get(cliKind.keys.command)).main;
 	return {
 		getCliHelp,
 		getEntry,
-		render: (width, withColors) => getCliHelp().render(event.get("command"), width, withColors),
+		render: (width, withColors) => getCliHelp().render(ctx.get(cliKind.keys.command), width, withColors),
 		print: (withColors) => {
-			getCliHelp().print(event.get("command"), withColors);
+			getCliHelp().print(ctx.get(cliKind.keys.command), withColors);
 		}
 	};
 }
@@ -362,7 +366,8 @@ function useAutoHelp(keys = ["help"], colors = true) {
 * ...
 */
 function useCommandLookupHelp(lookupDepth = 3) {
-	const parts = useCliContext().store("event").get("pathParams")?.flatMap((p) => `${p} `.split(":").map((s, i) => i ? `:${s}` : s)) || [];
+	const ctx = (0, __wooksjs_event_core.current)();
+	const parts = ctx.get(cliKind.keys.pathParams)?.flatMap((p) => `${p} `.split(":").map((s, i) => i ? `:${s}` : s)) || [];
 	const cliHelp = useCliHelp().getCliHelp();
 	const cmd = cliHelp.getCliName();
 	let data;
@@ -385,12 +390,25 @@ function useCommandLookupHelp(lookupDepth = 3) {
 
 //#endregion
 exports.WooksCli = WooksCli;
+exports.cliKind = cliKind;
 exports.cliShortcuts = cliShortcuts;
 exports.createCliApp = createCliApp;
 exports.createCliContext = createCliContext;
+exports.flagsKey = flagsKey;
 exports.useAutoHelp = useAutoHelp;
-exports.useCliContext = useCliContext;
 exports.useCliHelp = useCliHelp;
 exports.useCliOption = useCliOption;
 exports.useCliOptions = useCliOptions;
-exports.useCommandLookupHelp = useCommandLookupHelp;
+exports.useCommandLookupHelp = useCommandLookupHelp;
+Object.defineProperty(exports, 'useLogger', {
+  enumerable: true,
+  get: function () {
+    return __wooksjs_event_core.useLogger;
+  }
+});
+Object.defineProperty(exports, 'useRouteParams', {
+  enumerable: true,
+  get: function () {
+    return __wooksjs_event_core.useRouteParams;
+  }
+});

package/dist/index.d.ts

@@ -4,23 +4,11 @@ import * as _prostojs_cli_help from '@prostojs/cli-help';
 import { CliHelpRenderer, TCliEntry, TCliHelpOptions } from '@prostojs/cli-help';
 import { TConsoleBase } from '@prostojs/logger';
 import * as _wooksjs_event_core from '@wooksjs/event-core';
-import { TEventOptions, TEmpty } from '@wooksjs/event-core';
+import { EventContextOptions } from '@wooksjs/event-core';
+export { EventContext, EventContextOptions, useLogger, useRouteParams } from '@wooksjs/event-core';
 import minimist from 'minimist';
 import { TProstoRouterPathHandle } from '@prostojs/router';
 
-/** Event data describing a CLI command invocation. */
-interface TCliEventData {
-    argv: string[];
-    pathParams: string[];
-    command: string;
-    opts?: minimist.Opts;
-    type: 'CLI';
-    cliHelp: TCliHelpRenderer;
-}
-/** Context store for CLI events, holding parsed flags. */
-interface TCliContextStore {
-    flags?: Record<string, boolean | string>;
-}
 /** Custom data attached to CLI help entries for handler resolution. */
 interface TCliHelpCustom {
     handler: TWooksHandler<any>;
@@ -45,7 +33,7 @@ interface TWooksCliOptions {
     onNotFound?: TWooksHandler;
     onUnknownCommand?: (params: string[], raiseError: () => void) => unknown;
     logger?: TConsoleBase;
-    eventOptions?: TEventOptions;
+    eventOptions?: EventContextOptions;
     cliHelp?: TCliHelpRenderer | TCliHelpOptions;
     router?: TWooksOptions['router'];
 }
@@ -133,6 +121,15 @@ declare class WooksCli extends WooksAdapterBase {
  */
 declare function createCliApp(opts?: TWooksCliOptions, wooks?: Wooks | WooksAdapterBase): WooksCli;
 
+declare const cliKind: _wooksjs_event_core.EventKind<{
+    argv: _wooksjs_event_core.SlotMarker<string[]>;
+    pathParams: _wooksjs_event_core.SlotMarker<string[]>;
+    command: _wooksjs_event_core.SlotMarker<string>;
+    opts: _wooksjs_event_core.SlotMarker<minimist.Opts | undefined>;
+    cliHelp: _wooksjs_event_core.SlotMarker<TCliHelpRenderer>;
+}>;
+declare const flagsKey: _wooksjs_event_core.Key<Record<string, string | boolean>>;
+
 /**
  * ## useCliHelp
  * ### Composable
@@ -232,14 +229,15 @@ declare function useCliOptions(): Record<string, string | boolean>;
  */
 declare function useCliOption(name: string): string | boolean;
 
-/** Creates a new async event context for a CLI command invocation. */
-declare function createCliContext(data: Omit<TCliEventData, 'type'>, options: TEventOptions): <T>(cb: (...a: unknown[]) => T) => T;
-/**
- * Wrapper on top of useEventContext that provides
- * proper context types for CLI event
- * @returns set of hooks { getCtx, restoreCtx, clearCtx, hookStore, getStore, setStore }
- */
-declare function useCliContext<T extends TEmpty>(): _wooksjs_event_core.TCtxHelpers<TCliContextStore & T & _wooksjs_event_core.TGenericContextStore<TCliEventData>>;
+interface TCliEventInput {
+    argv: string[];
+    pathParams: string[];
+    command: string;
+    opts?: minimist.Opts;
+    cliHelp: TCliHelpRenderer;
+}
+/** Creates a new event context for a CLI command invocation. */
+declare function createCliContext(data: TCliEventInput, options: EventContextOptions): <R>(fn: () => R) => R;
 
-export { WooksCli, cliShortcuts, createCliApp, createCliContext, useAutoHelp, useCliContext, useCliHelp, useCliOption, useCliOptions, useCommandLookupHelp };
-export type { TCliContextStore, TCliEventData, TCliHelpCustom, TCliHelpRenderer, TWooksCliEntry, TWooksCliOptions };
+export { WooksCli, cliKind, cliShortcuts, createCliApp, createCliContext, flagsKey, useAutoHelp, useCliHelp, useCliOption, useCliOptions, useCommandLookupHelp };
+export type { TCliEventInput, TCliHelpCustom, TCliHelpRenderer, TWooksCliEntry, TWooksCliOptions };

package/dist/index.mjs

@@ -1,26 +1,30 @@
 import { CliHelpRenderer } from "@prostojs/cli-help";
+import { EventContext, current, defineEventKind, key, run, slot, useLogger, useRouteParams } from "@wooksjs/event-core";
 import minimist from "minimist";
 import { WooksAdapterBase } from "wooks";
-import { createAsyncEventContext, useAsyncEventContext } from "@wooksjs/event-core";
 
+//#region packages/event-cli/src/cli-kind.ts
+const cliKind = defineEventKind("CLI", {
+	argv: slot(),
+	pathParams: slot(),
+	command: slot(),
+	opts: slot(),
+	cliHelp: slot()
+});
+const flagsKey = key("cli.flags");
+
+//#endregion
 //#region packages/event-cli/src/event-cli.ts
-/** Creates a new async event context for a CLI command invocation. */
+/** Creates a new event context for a CLI command invocation. */
 function createCliContext(data, options) {
-	return createAsyncEventContext({
-		event: {
-			...data,
-			type: "CLI"
-		},
-		options
-	});
-}
-/**
-* Wrapper on top of useEventContext that provides
-* proper context types for CLI event
-* @returns set of hooks { getCtx, restoreCtx, clearCtx, hookStore, getStore, setStore }
-*/
-function useCliContext() {
-	return useAsyncEventContext("CLI");
+	const ctx = new EventContext(options);
+	return (fn) => run(ctx, () => ctx.seed(cliKind, {
+		argv: data.argv,
+		pathParams: data.pathParams,
+		command: data.command,
+		opts: data.opts,
+		cliHelp: data.cliHelp
+	}, fn));
 }
 
 //#endregion
@@ -138,13 +142,13 @@ var WooksCli = class extends WooksAdapterBase {
 			pathParams,
 			cliHelp: this.cliHelp,
 			command: path.replace(/\//gu, " ").trim()
-		}, this.mergeEventOptions(this.opts?.eventOptions));
+		}, this.getEventContextOptions());
 		return runInContext(async () => {
-			const { store } = useCliContext();
-			store("flags").value = parsedFlags;
+			const ctx = current();
+			ctx.set(flagsKey, parsedFlags);
 			this.computeAliases();
 			const { handlers: foundHandlers, firstStatic } = this.wooks.lookup("CLI", path);
-			if (typeof firstStatic === "string") store("event").set("command", firstStatic.replace(/\//gu, " ").trim());
+			if (typeof firstStatic === "string") ctx.set(cliKind.keys.command, firstStatic.replace(/\//gu, " ").trim());
 			const handlers = foundHandlers || this.opts?.onNotFound && [this.opts.onNotFound] || null;
 			if (handlers) try {
 				for (const handler of handlers) {
@@ -216,13 +220,13 @@ function createCliApp(opts, wooks) {
 * @returns an object with CLI options
 */
 function useCliOptions() {
-	const { store } = useCliContext();
-	const flags = store("flags");
-	if (!flags.value) {
-		const event = store("event");
-		flags.value = minimist(event.get("argv"), event.get("opts"));
+	const ctx = current();
+	if (!ctx.has(flagsKey)) {
+		const argv = ctx.get(cliKind.keys.argv);
+		const opts = ctx.get(cliKind.keys.opts);
+		ctx.set(flagsKey, minimist(argv, opts));
 	}
-	return flags.value;
+	return ctx.get(flagsKey);
 }
 /**
 * Getter for Cli Option value
@@ -242,7 +246,7 @@ function useCliOption(name) {
 		const options = useCliHelp().getEntry().options || [];
 		const opt = options.find((o) => o.keys.includes(name));
 		if (opt) {
-			for (const key of opt.keys) if (useCliOptions()[key]) return useCliOptions()[key];
+			for (const key$1 of opt.keys) if (useCliOptions()[key$1]) return useCliOptions()[key$1];
 		}
 	} catch {}
 	return useCliOptions()[name];
@@ -264,15 +268,15 @@ function useCliOption(name) {
 * @returns
 */
 function useCliHelp() {
-	const event = useCliContext().store("event");
-	const getCliHelp = () => event.get("cliHelp");
-	const getEntry = () => getCliHelp().match(event.get("command")).main;
+	const ctx = current();
+	const getCliHelp = () => ctx.get(cliKind.keys.cliHelp);
+	const getEntry = () => getCliHelp().match(ctx.get(cliKind.keys.command)).main;
 	return {
 		getCliHelp,
 		getEntry,
-		render: (width, withColors) => getCliHelp().render(event.get("command"), width, withColors),
+		render: (width, withColors) => getCliHelp().render(ctx.get(cliKind.keys.command), width, withColors),
 		print: (withColors) => {
-			getCliHelp().print(event.get("command"), withColors);
+			getCliHelp().print(ctx.get(cliKind.keys.command), withColors);
 		}
 	};
 }
@@ -339,7 +343,8 @@ function useAutoHelp(keys = ["help"], colors = true) {
 * ...
 */
 function useCommandLookupHelp(lookupDepth = 3) {
-	const parts = useCliContext().store("event").get("pathParams")?.flatMap((p) => `${p} `.split(":").map((s, i) => i ? `:${s}` : s)) || [];
+	const ctx = current();
+	const parts = ctx.get(cliKind.keys.pathParams)?.flatMap((p) => `${p} `.split(":").map((s, i) => i ? `:${s}` : s)) || [];
 	const cliHelp = useCliHelp().getCliHelp();
 	const cmd = cliHelp.getCliName();
 	let data;
@@ -361,4 +366,4 @@ function useCommandLookupHelp(lookupDepth = 3) {
 }
 
 //#endregion
-export { WooksCli, cliShortcuts, createCliApp, createCliContext, useAutoHelp, useCliContext, useCliHelp, useCliOption, useCliOptions, useCommandLookupHelp };
+export { WooksCli, cliKind, cliShortcuts, createCliApp, createCliContext, flagsKey, useAutoHelp, useCliHelp, useCliOption, useCliOptions, useCommandLookupHelp, useLogger, useRouteParams };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wooksjs/event-cli",
-  "version": "0.6.6",
+  "version": "0.7.0",
   "description": "@wooksjs/event-cli",
   "keywords": [
     "api",
@@ -26,7 +26,7 @@
     "directory": "packages/event-cli"
   },
   "bin": {
-    "setup-skills": "scripts/setup-skills.js"
+    "wooksjs-event-cli-skill": "scripts/setup-skills.js"
   },
   "files": [
     "dist",
@@ -52,14 +52,14 @@
     "@types/minimist": "^1.2.5",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@wooksjs/event-core": "^0.6.6",
-    "wooks": "^0.6.6"
+    "@wooksjs/event-core": "^0.7.0",
+    "wooks": "^0.7.0"
   },
   "peerDependencies": {
     "@prostojs/logger": "^0.4.3",
-    "@prostojs/router": "^0.3.1",
-    "@wooksjs/event-core": "^0.6.6",
-    "wooks": "^0.6.6"
+    "@prostojs/router": "^0.3.2",
+    "@wooksjs/event-core": "^0.7.0",
+    "wooks": "^0.7.0"
   },
   "scripts": {
     "build": "rolldown -c ../../rolldown.config.mjs",

package/skills/wooksjs-event-cli/SKILL.md

@@ -1,35 +1,31 @@
 ---
 name: wooksjs-event-cli
-description: Wooks CLI framework — composable, command-line application framework for Node.js. Load when building CLI apps with wooks; defining CLI commands or using the wooks router for command routing; using CLI composables (useCliOptions, useCliOption, useCliHelp, useAutoHelp, useCommandLookupHelp, useRouteParams); creating custom event context composables; working with @wooksjs/event-core context store (init, get, set, hook); parsing CLI flags and options; generating command help and usage text; handling unknown commands; building multi-command CLI tools.
+description: Use this skill when working with @wooksjs/event-cli — to build CLI applications with createCliApp(), register commands with app.cli(), parse flags and options with useCliOptions()/useCliOption(), generate auto-help with useCliHelp()/useAutoHelp(), handle unknown commands with useCommandLookupHelp(), define command aliases/args/options metadata, or run CLI commands programmatically with app.run().
 ---
 
 # @wooksjs/event-cli
 
-A composable CLI framework for Node.js built on async context (AsyncLocalStorage). Instead of imperative argument parsing libraries, you call composable functions (`useCliOptions()`, `useCliHelp()`, etc.) anywhere in your command handler — flags are parsed on demand and cached per invocation.
+CLI adapter for Wooks. Build command-line applications with the same composable architecture as Wooks HTTP — routed commands, typed options, auto-generated help, and per-invocation context.
 
 ## How to use this skill
 
 Read the domain file that matches the task. Do not load all files — only what you need.
 
-| Domain | File | Load when... |
-|--------|------|------------|
-| Event context (core machinery) | [event-core.md](event-core.md) | Understanding the context store API (`init`/`get`/`set`/`hook`), creating custom composables, lazy evaluation and caching, building your own `use*()` functions |
-| CLI app setup | [core.md](core.md) | Creating a CLI app, running commands, `createCliApp`, `app.run()`, error handling, unknown command handling, sharing routers, testing |
-| Commands & help | [commands.md](commands.md) | Defining commands with `app.cli()`, command syntax (args, aliases, options, examples), help generation (`useCliHelp`, `useAutoHelp`, `useCommandLookupHelp`), accessing flags (`useCliOptions`, `useCliOption`), route params in CLI |
+| Domain               | File                       | Load when...                                                                                                                |
+| -------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| Core setup & routing | [core.md](core.md)         | Creating a CLI app, registering commands, running commands, understanding the architecture                                  |
+| Commands & help      | [commands.md](commands.md) | Command registration with options/args/aliases, help generation, composables (`useCliOptions`, `useCliHelp`, `useAutoHelp`) |
 
 ## Quick reference
 
 ```ts
-import { useRouteParams } from '@wooksjs/event-core'
-import { createCliApp, useCliOptions } from '@wooksjs/event-cli'
-
-const app = createCliApp()
-app.cli('greet/:name', () => {
-  const { get } = useRouteParams<{ name: string }>()
-  const flags = useCliOptions()
-  return `Hello, ${get('name')}!`
-})
-app.run()
+import { createCliApp } from '@wooksjs/event-cli'
+import { useRouteParams, useLogger } from '@wooksjs/event-cli'
+import {
+  useCliOptions,
+  useCliOption,
+  useCliHelp,
+  useAutoHelp,
+  useCommandLookupHelp,
+} from '@wooksjs/event-cli'
 ```
-
-Key composables: `useCliOptions()`, `useCliOption(name)`, `useCliHelp()`, `useAutoHelp()`, `useCommandLookupHelp()`, `useRouteParams()`, `useEventId()`, `useEventLogger()`.