halleyfy 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,97 @@
-# Temporary Holding Version
+# halleyfy
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Images, video, voice, sound effects and music for AI agents, from one CLI.
+
+halleyfy is a command-line tool built for agents: Claude Code, Codex, opencode, Cursor, Gemini CLI and anything else that can run a shell command. The agent writes the request. halleyfy picks the model, runs it and saves the file. You pay per result from a prepaid balance. There is no subscription and no model API key to set up.
+
+```bash
+npm install -g halleyfy
+halleyfy login
+halleyfy topup 10
+halleyfy image "a red ceramic mug on white marble, studio light"
+```
+
+The last line saves a `.png` in the current folder and prints its path.
+
+Docs: [halleyfy.com/docs](https://halleyfy.com/docs)
+
+## Install
+
+```bash
+npm install -g halleyfy
+```
+
+Or with Bun: `bun add -g halleyfy`. Or with no install at all: `npx -y halleyfy <command>`.
+
+Add the agent skills with the [Skills CLI](https://skills.sh). They teach Claude Code, Codex, Cursor, opencode and other agents when and how to use halleyfy:
+
+```bash
+npx skills add supasanahq/halleyfy-skills -g
+```
+
+On macOS and Linux, one line installs the CLI and the skills without Node:
+
+```bash
+curl -fsSL https://halleyfy.com/install.sh | sh
+```
+
+## What it makes
+
+| Command | What you get |
+|---|---|
+| `halleyfy image` | Images from a prompt, or edits guided by up to 16 reference images. 1K to 4K, transparent PNGs too. |
+| `halleyfy video` | A 3 to 15 second video with sound, 360p to 4K, from a prompt, a start image, references, or an edit of a clip. |
+| `halleyfy speak` | Speech from text in one of 21 voices. |
+| `halleyfy revoice` | The same words in another voice, with the same timing. |
+| `halleyfy isolate` | A clean voice pulled out of a noisy recording. |
+| `halleyfy sound` | A sound effect, or a whole soundtrack for a clip. |
+| `halleyfy music` | An instrumental, a song, or a score fitted to a clip. |
+| `halleyfy lipsync` | A video with the lips moved to a new line. |
+| `halleyfy dub` | A video or recording in another language, each speaker in their own voice. |
+| `halleyfy watch` | A transcript and contact sheets, so an agent can see and hear a video. |
+
+```bash
+halleyfy video "a red mug slowly turning on white marble" --seconds 5
+halleyfy speak "Welcome back. Your order is on its way." --voice George
+halleyfy music "warm lo-fi hip hop, 80 bpm, soft keys and vinyl crackle"
+halleyfy dub ./talk.mp4 --to de
+```
+
+## Built for agents
+
+- `halleyfy <command> --help` lists every flag, its allowed values, its default and today's prices.
+- `--dry-run` prints the price and runs nothing. `--max-cost 1` refuses a run above $1.
+- `--json` prints one JSON document: `{"job", "files": [paths], "cost_usd", "target"}`.
+- Exit codes: 0 done, 1 error, 2 a cost limit, 3 the job failed (nothing charged), 4 not enough balance.
+- An agent can ask for a top-up, but only a person can approve one, in their browser.
+
+The first real command installs the halleyfy skills for Claude Code, Codex and other agents (`~/.claude/skills` and `~/.agents/skills`). They teach an agent when to use halleyfy and how to write a prompt that comes out right the first time. To install them yourself:
+
+```bash
+halleyfy skills install
+```
+
+Then ask your agent in plain words:
+
+> Use halleyfy to make a hero image for my landing page: a glass comet over a dark sea, left side empty for the headline.
+
+To make an agent always reach for it, add this line to `AGENTS.md` or `CLAUDE.md`:
+
+```
+To make images, videos, speech, sound effects or music, use the halleyfy CLI (`halleyfy image`, `halleyfy video`, `halleyfy speak`, `halleyfy sound`, `halleyfy music`); run `halleyfy <command> --help` first.
+```
+
+## Pricing
+
+No subscription. Top up a balance by card, $10 to $500 at a time. Each result's price is shown before it runs and charged when it is delivered. A job that fails costs nothing. Today's prices are on [halleyfy.com](https://halleyfy.com) and in each command's `--help`.
+
+## Links
+
+- [Quickstart](https://halleyfy.com/docs/quickstart)
+- [For AI agents](https://halleyfy.com/docs/for-agents)
+- [Claude Code](https://halleyfy.com/docs/claude-code), [Codex](https://halleyfy.com/docs/codex), [other agents](https://halleyfy.com/docs/other-agents)
+- [CLI reference](https://halleyfy.com/docs/cli) and [REST API](https://halleyfy.com/docs/api)
+- [Skills and plugins](https://github.com/supasanahq/halleyfy-skills)
+- Support: support@halleyfy.com
+
+Needs Node 18 or newer for the launcher. On Alpine, add `libstdc++` (`apk add libstdc++`).

package/bin/halleyfy.cjs

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+// Launcher for the `halleyfy` npm package: runs the compiled binary from this platform's optional package.
+const { spawnSync } = require("node:child_process");
+const { isMusl, packageFor } = require("./select.cjs");
+
+const pkg = packageFor(process.platform, process.arch, isMusl());
+if (!pkg) {
+  console.error(`halleyfy has no build for ${process.platform}-${process.arch}.`);
+  process.exit(1);
+}
+const exe = process.platform === "win32" ? "halleyfy.exe" : "halleyfy";
+let bin;
+try {
+  bin = require.resolve(`${pkg}/bin/${exe}`);
+} catch {
+  console.error(`halleyfy needs the ${pkg} package, which isn't installed. Reinstall without --omit=optional (or --no-optional).`);
+  process.exit(1);
+}
+const r = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+if (r.error) {
+  console.error(`Couldn't run ${bin}: ${r.error.message}`);
+  process.exit(1);
+}
+if (r.signal) process.kill(process.pid, r.signal);
+process.exit(r.status === null ? 1 : r.status);

package/bin/select.cjs

@@ -0,0 +1,25 @@
+// Picks the platform package for this machine. Hand-written CommonJS (it ships as-is in the launcher
+// package); platforms.test.ts checks it against TARGETS.
+const fs = require("node:fs");
+
+function isMusl() {
+  if (process.platform !== "linux") return false;
+  const report = process.report && process.report.getReport ? process.report.getReport() : null;
+  if (report && report.header) return !report.header.glibcVersionRuntime;
+  try {
+    return fs.readdirSync("/lib").some((f) => f.startsWith("ld-musl-"));
+  } catch {
+    return false;
+  }
+}
+
+function packageFor(platform, arch, musl) {
+  const cpu = arch === "x64" || arch === "arm64" ? arch : null;
+  if (!cpu) return null;
+  if (platform === "darwin") return `@halleyfy/cli-darwin-${cpu}`;
+  if (platform === "win32") return cpu === "x64" ? "@halleyfy/cli-windows-x64" : null;
+  if (platform === "linux") return `@halleyfy/cli-linux-${cpu}${musl ? "-musl" : ""}`;
+  return null;
+}
+
+module.exports = { isMusl, packageFor };

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "halleyfy",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Images, video, voice, sound effects and music for AI agents, from one CLI. Works with Claude Code, Codex and any agent that can run a shell command. Pay per result.",
+  "keywords": [
+    "ai",
+    "ai-agents",
+    "agent-skills",
+    "cli",
+    "claude-code",
+    "codex",
+    "cursor",
+    "opencode",
+    "generative-ai",
+    "image-generation",
+    "text-to-image",
+    "image-editing",
+    "video-generation",
+    "text-to-video",
+    "image-to-video",
+    "text-to-speech",
+    "tts",
+    "voiceover",
+    "music-generation",
+    "sound-effects",
+    "lip-sync",
+    "dubbing",
+    "content-creation"
+  ],
+  "homepage": "https://halleyfy.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/supasanahq/halleyfy-skills.git"
+  },
+  "bugs": {
+    "url": "https://github.com/supasanahq/halleyfy-skills/issues",
+    "email": "support@halleyfy.com"
+  },
+  "bin": {
+    "halleyfy": "bin/halleyfy.cjs"
+  },
+  "optionalDependencies": {
+    "@halleyfy/cli-darwin-arm64": "0.1.1",
+    "@halleyfy/cli-darwin-x64": "0.1.1",
+    "@halleyfy/cli-linux-x64": "0.1.1",
+    "@halleyfy/cli-linux-arm64": "0.1.1",
+    "@halleyfy/cli-linux-x64-musl": "0.1.1",
+    "@halleyfy/cli-linux-arm64-musl": "0.1.1",
+    "@halleyfy/cli-windows-x64": "0.1.1"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "UNLICENSED"
+}