deweyou-cli 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.5.0 - 2026-05-17
+
+### Added
+
+- add deweyou-cli help and version flags
 ## 0.4.0 - 2026-05-17
 
 ### Added

package/README.md

@@ -37,6 +37,8 @@ cd /path/to/your/repo
 deweyou-cli agent init
 deweyou-cli agent doctor
 deweyou-cli agent context --format markdown
+deweyou-cli agent -h
+deweyou-cli -v
 ```
 
 For a non-interactive setup that selects everything:
@@ -59,6 +61,13 @@ skills and rules; a writing or design repo can select different ones.
 
 ## Commands
 
+General options:
+
+| Option | Meaning |
+|--------|---------|
+| `-h`, `--help` | Show help. Supports nested help such as `deweyou-cli agent -h` and `deweyou-cli agent init -h`. |
+| `-v`, `--version` | Show the installed CLI version. |
+
 ### `deweyou-cli agent update`
 
 Refreshes the local Dewey asset cache from the default `deweyou/agents` source

package/dist/deweyou.mjs

@@ -82,8 +82,26 @@ function toCamel(value) {
 	return value.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
 }
 //#endregion
+//#region package.json
+var version = "0.5.0";
+//#endregion
 //#region src/cli/main.ts
+const COMMANDS = [
+	"init",
+	"update",
+	"context",
+	"doctor"
+];
 async function main(argv) {
+	const help = helpFor(argv);
+	if (help) {
+		console.log(help);
+		return;
+	}
+	if (isVersionRequest(argv)) {
+		console.log(version);
+		return;
+	}
 	const parsed = parseArgs(argv);
 	if (parsed.topic !== "agent") printUsageAndThrow();
 	if (parsed.command === "init") {
@@ -109,16 +127,87 @@ async function main(argv) {
 	printUsageAndThrow();
 }
 function usage() {
+	return rootUsage();
+}
+function rootUsage() {
+	return `Usage:
+  deweyou-cli agent <command> [options]
+
+Commands:
+  agent init      Initialize the current repository with Dewey assets.
+  agent update    Refresh the local Dewey asset cache.
+  agent context   Print the active Dewey agent context.
+  agent doctor    Check whether the repository and cache are healthy.
+
+Options:
+  -h, --help      Show help.
+  -v, --version   Show the CLI version.`;
+}
+function agentUsage() {
 	return `Usage:
   deweyou-cli agent init [--all] [--skills a,b] [--rules a,b] [--mode link|copy|pointer] [--scope project|global] [--tools codex,claude|all] [--rule-wiring reference|inline] [--yes] [--dry-run] [--force]
   deweyou-cli agent update
   deweyou-cli agent context [--format markdown|json]
-  deweyou-cli agent doctor`;
+  deweyou-cli agent doctor
+
+Run \`deweyou-cli agent <command> -h\` for command-specific help.`;
+}
+function commandUsage(command) {
+	if (command === "init") return `Usage:
+  deweyou-cli agent init [--all] [--skills a,b] [--rules a,b] [--mode link|copy|pointer] [--scope project|global] [--tools codex,claude|all] [--rule-wiring reference|inline] [--yes] [--dry-run] [--force]
+
+Options:
+  --all                         Select every skill and rule.
+  --skills a,b                  Select comma-separated skill ids.
+  --rules a,b                   Select comma-separated rule ids.
+  --mode link|copy|pointer      Choose how assets are referenced.
+  --scope project|global        Write project or user-level instructions.
+  --tools codex,claude|all      Select target agent tools.
+  --rule-wiring reference|inline
+                                Choose how rules are written into instructions.
+  --yes                         Run without prompts for scripted selections.
+  --dry-run                     Print the plan without writing files.
+  --force                       Replace existing Dewey-managed destinations.
+  -h, --help                    Show help.`;
+	if (command === "context") return `Usage:
+  deweyou-cli agent context [--format markdown|json]
+
+Options:
+  --format markdown|json   Choose human-readable or structured output.
+  -h, --help               Show help.`;
+	if (command === "update") return `Usage:
+  deweyou-cli agent update
+
+Options:
+  -h, --help   Show help.`;
+	return `Usage:
+  deweyou-cli agent doctor
+
+Options:
+  -h, --help   Show help.`;
 }
 function printUsageAndThrow() {
 	console.log(usage());
 	throw usageError("", { silent: true });
 }
+function helpFor(argv) {
+	if (!argv.some(isHelpFlag)) return null;
+	if (isHelpFlag(argv[0])) return rootUsage();
+	if (argv[0] !== "agent") return rootUsage();
+	const command = argv[1];
+	if (!command || isHelpFlag(command)) return agentUsage();
+	if (isAgentCommand(command)) return commandUsage(command);
+	return agentUsage();
+}
+function isVersionRequest(argv) {
+	return argv.length === 1 && (argv[0] === "-v" || argv[0] === "--version");
+}
+function isHelpFlag(value) {
+	return value === "-h" || value === "--help";
+}
+function isAgentCommand(value) {
+	return COMMANDS.includes(value);
+}
 //#endregion
 //#region src/bin/deweyou.ts
 main(process.argv.slice(2)).catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deweyou-cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "type": "module",
   "description": "Dewey's personal agent workflow bootstrapper",
   "files": [