diff --git a/.changeset/metrics-unknown-subcommand-silent.md b/.changeset/metrics-unknown-subcommand-silent.md
new file mode 100644
index 0000000..d24fdd3
--- /dev/null
+++ b/.changeset/metrics-unknown-subcommand-silent.md
@@ -0,0 +1,5 @@
+---
+"@generata/core": patch
+---
+
+fix: error handling for unknown metrics subcommands
diff --git a/packages/core/src/cli.ts b/packages/core/src/cli.ts
index 3d9c801..0c98d6c 100644
--- a/packages/core/src/cli.ts
+++ b/packages/core/src/cli.ts
@@ -350,6 +350,10 @@ async function main() {
         console.log(`  Avg duration:  ${fmt.dim(`${Math.round(avgDuration)}ms`)}`);
         console.log(`  Failures:      ${failures > 0 ? fmt.fail(String(failures)) : fmt.dim("0")}`);
       }
+    } else {
+      console.error(fmt.fail(`Unknown metrics subcommand: '${target}'`));
+      console.error(fmt.dim("Usage: generata metrics [today|week|expensive|agent <name>]"));
+      process.exit(1);
     }
     return;
   }