whatsapp-web-cli 0.1.0 → 0.2.0

package/README.md

@@ -40,6 +40,18 @@ Then run the command you actually need:
 wwa chat-search "Name" --json
 ```
 
+To install the bundled Codex skill for local agent use:
+
+```bash
+wwa skill install --json
+```
+
+By default this writes:
+
+```text
+~/.codex/skills/whatsapp-cli/SKILL.md
+```
+
 If WhatsApp is not logged in, data commands return a JSON object like:
 
 ```json
@@ -169,10 +181,16 @@ You should only need to scan a QR again if WhatsApp invalidates the linked devic
 
 ## Codex Skill
 
-The generic skill lives at:
+The generic skill is included in the package at:
 
 ```text
 skills/whatsapp-cli/SKILL.md
 ```
 
+Install or update it for Codex with:
+
+```bash
+wwa skill install --json
+```
+
 It teaches agents to use the CLI directly, without MCP, and keeps transcription/classification workflows outside the low-level CLI.

package/dist/wwa.js

@@ -326990,6 +326990,13 @@ var {
   Help
 } = import__.default;
 
+// src/cli.ts
+import { copyFile as copyFile2, mkdir as mkdir5 } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { dirname as dirname7, join as join2, resolve as resolve9 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+
 // src/daemon.ts
 import { createServer } from "node:http";
 import { readFile as readFile3 } from "node:fs/promises";
@@ -342824,6 +342831,11 @@ async function main(argv) {
   program2.command("paths").description("Show local runtime paths.").option("--json", "Print JSON output.").action((options) => {
     output(options, paths, paths);
   });
+  const skill = program2.command("skill").description("Install helper files for agent integrations.");
+  skill.command("install").description("Install the bundled Codex skill into a local Codex skills directory.").option("--dir <path>", "Codex skills directory.", join2(homedir2(), ".codex", "skills")).option("--name <name>", "Installed skill directory name.", "whatsapp-cli").option("--json", "Print JSON output.").action(async (options) => {
+    const result = await installCodexSkill(options);
+    output(options, result, `Installed ${result.name} skill at ${result.installedPath}`);
+  });
   try {
     await program2.parseAsync(argv);
   } catch (error51) {
@@ -342842,6 +342854,34 @@ function output(options, data, human) {
 function isTimeoutResult(value) {
   return Boolean(value && typeof value === "object" && "timedOut" in value && value.timedOut === true);
 }
+async function installCodexSkill(options) {
+  const sourcePath = resolveBundledSkillPath();
+  const skillRoot = resolve9(options.dir);
+  const installedDir = join2(skillRoot, options.name);
+  const installedPath = join2(installedDir, "SKILL.md");
+  await mkdir5(installedDir, { recursive: true });
+  await copyFile2(sourcePath, installedPath);
+  return {
+    ok: true,
+    name: options.name,
+    sourcePath,
+    installedPath,
+    skillsDir: skillRoot
+  };
+}
+function resolveBundledSkillPath() {
+  const moduleDir = dirname7(fileURLToPath2(import.meta.url));
+  const candidates = [
+    join2(moduleDir, "..", "skills", "whatsapp-cli", "SKILL.md"),
+    join2(moduleDir, "skills", "whatsapp-cli", "SKILL.md"),
+    join2(process.cwd(), "skills", "whatsapp-cli", "SKILL.md")
+  ];
+  const found = candidates.find((candidate) => existsSync(candidate));
+  if (!found) {
+    throw new Error(`Could not find bundled whatsapp-cli skill. Checked: ${candidates.join(", ")}`);
+  }
+  return found;
+}
 async function ensureReady(options, waitSeconds = 60) {
   let status;
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "whatsapp-web-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A local WhatsApp Web CLI for agents and scripts.",
   "type": "module",
   "bin": {