diff --git a/package.json b/package.json
index 9ef5eaac..49b82784 100644
--- a/package.json
+++ b/package.json
@@ -28,6 +28,7 @@
     "test:visual:update": "npm run build && cross-env UPDATE_VISUAL_BASELINES=1 npx playwright test",
     "test:e2e": "npm run build && npx playwright test tests/e2e",
     "test:load": "node scripts/agent/load-test.mjs",
+    "test:smoke": "node scripts/agent/smoke-test.mjs",
     "test:dm:unit": "node scripts/run-targeted-tests.mjs tests/dm-db.test.mjs tests/dm-decryptor.test.mjs tests/dm-normalization.test.mjs tests/nostr-send-direct-message.test.mjs",
     "test:dm:integration": "node scripts/run-targeted-tests.mjs tests/nostr/dm-direct-message-flow.test.mjs",
     "test:unit": "node scripts/run-unit-tests.mjs",
diff --git a/scripts/agent/smoke-test.mjs b/scripts/agent/smoke-test.mjs
index 83d4fc95..74c5cd7e 100644
--- a/scripts/agent/smoke-test.mjs
+++ b/scripts/agent/smoke-test.mjs
@@ -1,3 +1,7 @@
+/**
+ * Smoke Test Script (Agent)
+ * Verifies key flows: login, relay connect, video post, DM decrypt.
+ */
 
 import './setup-test-env.js';
 import { startRelay } from './load-test-relay.mjs';