@fionoble/image-gen-cli 1.0.0

package/README.md

@@ -0,0 +1,91 @@
+# @fionoble/image-gen-cli
+
+A CLI tool for generating and editing images using OpenAI's `gpt-image-1` model. Comes with a [Claude Code](https://claude.com/claude-code) skill for seamless AI-assisted image generation.
+
+## Install
+
+```bash
+npm install -g @fionoble/image-gen-cli
+```
+
+Or use without installing:
+
+```bash
+npx @fionoble/image-gen-cli -p "A cat in a spacesuit" -o cat.png
+```
+
+### Prerequisites
+
+- Node.js 18+
+- An [OpenAI API key](https://platform.openai.com/api-keys) set as `OPENAI_API_KEY`
+
+```bash
+export OPENAI_API_KEY="sk-..."
+```
+
+## CLI Usage
+
+```
+image-gen [options]
+```
+
+### Options
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `-p, --prompt <text>` | Image prompt (required) | - |
+| `-i, --image <path>` | Input image for editing | - |
+| `-o, --output <path>` | Output file path | `generated-<timestamp>.png` |
+| `-s, --size <size>` | `1024x1024`, `1024x1536`, `1536x1024`, `auto` | `auto` |
+| `-q, --quality <quality>` | `low`, `medium`, `high`, `auto` | `auto` |
+| `-n, --count <n>` | Number of images to generate | `1` |
+| `-m, --model <model>` | OpenAI model | `gpt-image-1` |
+| `--install-skill` | Install the Claude Code skill | - |
+| `--uninstall-skill` | Remove the Claude Code skill | - |
+
+### Examples
+
+Generate an image:
+
+```bash
+image-gen -p "A watercolor painting of a Japanese garden" -q high -o garden.png
+```
+
+Edit an existing image:
+
+```bash
+image-gen -p "Make the sky a dramatic sunset" -i photo.png -o photo-sunset.png
+```
+
+Generate a logo:
+
+```bash
+image-gen -p "Minimalist coffee shop logo" -q high -s 1024x1024 -o logo.png
+```
+
+## Claude Code Skill
+
+Install the skill so Claude Code can generate images for you:
+
+```bash
+image-gen --install-skill
+# or
+npx @fionoble/image-gen-cli --install-skill
+```
+
+Once installed, the `/image-gen` skill is available in Claude Code. You can either:
+
+- Invoke it directly: `/image-gen create a logo for my app`
+- Or just ask naturally: "generate an image of a cat in space"
+
+Claude will craft a detailed prompt, pick appropriate settings, generate the image, and display the result.
+
+To remove the skill:
+
+```bash
+image-gen --uninstall-skill
+```
+
+## License
+
+ISC

package/index.js

@@ -0,0 +1,231 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const OpenAI = require("openai").default;
+
+function printUsage() {
+  console.log(`Usage: image-gen [options]
+
+Generate or edit images using OpenAI's gpt-image-1 model.
+
+Options:
+  -p, --prompt <text>       Image prompt (required)
+  -i, --image <path>        Input image for editing (optional)
+  -o, --output <path>       Output file path (default: generated-<timestamp>.png)
+  -s, --size <size>         Image size: 1024x1024, 1024x1536, 1536x1024, auto (default: auto)
+  -q, --quality <quality>   Quality: low, medium, high, auto (default: auto)
+  -n, --count <n>           Number of images to generate (default: 1)
+  -m, --model <model>       Model: gpt-image-1 (default: gpt-image-1)
+  --install-skill           Install the Claude Code skill to ~/.claude/skills/
+  --uninstall-skill         Remove the Claude Code skill
+  -h, --help                Show this help message
+
+Environment:
+  OPENAI_API_KEY            Required. Your OpenAI API key.
+
+Examples:
+  image-gen -p "A cat in a spacesuit"
+  image-gen -p "Make the background blue" -i photo.png
+  image-gen -p "A logo for a coffee shop" -s 1024x1024 -q high -o logo.png
+  npx @fionoble/image-gen-cli --install-skill
+`);
+}
+
+function installSkill() {
+  const os = require("os");
+  const skillDir = path.join(os.homedir(), ".claude", "skills", "image-gen");
+  const source = path.join(__dirname, "skill", "SKILL.md");
+
+  if (!fs.existsSync(source)) {
+    console.error("Error: SKILL.md not found in package. Try reinstalling.");
+    process.exit(1);
+  }
+
+  fs.mkdirSync(skillDir, { recursive: true });
+  fs.copyFileSync(source, path.join(skillDir, "SKILL.md"));
+  console.log(`Claude Code skill installed to ${skillDir}/SKILL.md`);
+}
+
+function uninstallSkill() {
+  const os = require("os");
+  const skillDir = path.join(os.homedir(), ".claude", "skills", "image-gen");
+  const skillFile = path.join(skillDir, "SKILL.md");
+
+  if (fs.existsSync(skillFile)) {
+    fs.unlinkSync(skillFile);
+    fs.rmdirSync(skillDir);
+    console.log("Claude Code skill removed.");
+  } else {
+    console.log("Skill not installed, nothing to remove.");
+  }
+}
+
+function parseArgs(argv) {
+  const args = {
+    prompt: null,
+    image: null,
+    output: null,
+    size: "auto",
+    quality: "auto",
+    count: 1,
+    model: "gpt-image-1",
+  };
+
+  for (let i = 2; i < argv.length; i++) {
+    const arg = argv[i];
+    switch (arg) {
+      case "-p":
+      case "--prompt":
+        args.prompt = argv[++i];
+        break;
+      case "-i":
+      case "--image":
+        args.image = argv[++i];
+        break;
+      case "-o":
+      case "--output":
+        args.output = argv[++i];
+        break;
+      case "-s":
+      case "--size":
+        args.size = argv[++i];
+        break;
+      case "-q":
+      case "--quality":
+        args.quality = argv[++i];
+        break;
+      case "-n":
+      case "--count":
+        args.count = parseInt(argv[++i], 10);
+        break;
+      case "-m":
+      case "--model":
+        args.model = argv[++i];
+        break;
+      case "--install-skill":
+        installSkill();
+        process.exit(0);
+      case "--uninstall-skill":
+        uninstallSkill();
+        process.exit(0);
+      case "-h":
+      case "--help":
+        printUsage();
+        process.exit(0);
+      default:
+        if (!args.prompt) {
+          args.prompt = arg;
+        } else {
+          console.error(`Unknown option: ${arg}`);
+          process.exit(1);
+        }
+    }
+  }
+
+  return args;
+}
+
+function resolveOutputPath(output, index, count) {
+  if (output && count === 1) {
+    return path.resolve(output);
+  }
+  const timestamp = Date.now();
+  const base = output
+    ? path.parse(output)
+    : { dir: ".", name: `generated-${timestamp}`, ext: ".png" };
+  if (count > 1) {
+    return path.resolve(base.dir, `${base.name}-${index + 1}${base.ext || ".png"}`);
+  }
+  return path.resolve(base.dir, `${base.name}${base.ext || ".png"}`);
+}
+
+async function generateImage(client, args) {
+  console.log(`Generating image with prompt: "${args.prompt}"`);
+
+  const params = {
+    model: args.model,
+    prompt: args.prompt,
+    n: args.count,
+    size: args.size,
+    quality: args.quality,
+  };
+
+  const result = await client.images.generate(params);
+
+  const paths = [];
+  for (let i = 0; i < result.data.length; i++) {
+    const outputPath = resolveOutputPath(args.output, i, args.count);
+    const imageBytes = Buffer.from(result.data[i].b64_json, "base64");
+    fs.writeFileSync(outputPath, imageBytes);
+    paths.push(outputPath);
+    console.log(`Saved: ${outputPath}`);
+  }
+  return paths;
+}
+
+async function editImage(client, args) {
+  const imagePath = path.resolve(args.image);
+  if (!fs.existsSync(imagePath)) {
+    console.error(`Input image not found: ${imagePath}`);
+    process.exit(1);
+  }
+
+  console.log(`Editing image "${imagePath}" with prompt: "${args.prompt}"`);
+
+  const imageFile = fs.createReadStream(imagePath);
+
+  const params = {
+    model: args.model,
+    prompt: args.prompt,
+    image: imageFile,
+    n: args.count,
+    size: args.size,
+    quality: args.quality,
+  };
+
+  const result = await client.images.edit(params);
+
+  const paths = [];
+  for (let i = 0; i < result.data.length; i++) {
+    const outputPath = resolveOutputPath(args.output, i, args.count);
+    const imageBytes = Buffer.from(result.data[i].b64_json, "base64");
+    fs.writeFileSync(outputPath, imageBytes);
+    paths.push(outputPath);
+    console.log(`Saved: ${outputPath}`);
+  }
+  return paths;
+}
+
+async function main() {
+  const args = parseArgs(process.argv);
+
+  if (!args.prompt) {
+    console.error("Error: --prompt is required");
+    printUsage();
+    process.exit(1);
+  }
+
+  if (!process.env.OPENAI_API_KEY) {
+    console.error("Error: OPENAI_API_KEY environment variable is not set");
+    process.exit(1);
+  }
+
+  const client = new OpenAI();
+
+  try {
+    if (args.image) {
+      await editImage(client, args);
+    } else {
+      await generateImage(client, args);
+    }
+  } catch (err) {
+    console.error(`Error: ${err.message}`);
+    if (err.status) {
+      console.error(`Status: ${err.status}`);
+    }
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@fionoble/image-gen-cli",
+  "version": "1.0.0",
+  "description": "CLI tool for OpenAI image generation and editing, with a Claude Code skill",
+  "main": "index.js",
+  "bin": {
+    "image-gen": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "skill/SKILL.md"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "openai",
+    "image-generation",
+    "gpt-image",
+    "cli",
+    "claude-code",
+    "ai"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Fionoble/image-gen-cli.git"
+  },
+  "author": "Fionoble",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "openai": "^6.25.0"
+  }
+}

package/skill/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: image-gen
+description: Generate or edit images using OpenAI's gpt-image-1 model. Use when the user asks to generate, create, or edit images using AI.
+allowed-tools: Bash, Read
+---
+
+# image-gen
+
+Generate or edit images using OpenAI's gpt-image-1 model via the `image-gen` CLI tool.
+
+## Tool Location
+
+Run with `image-gen` (if globally installed via `npm link`) or `npx image-gen-cli`.
+
+## Usage
+
+```
+image-gen [options]
+```
+
+### Options
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `-p, --prompt <text>` | Image prompt (required) | - |
+| `-i, --image <path>` | Input image path for editing | - |
+| `-o, --output <path>` | Output file path | `generated-<timestamp>.png` |
+| `-s, --size <size>` | `1024x1024`, `1024x1536`, `1536x1024`, `auto` | `auto` |
+| `-q, --quality <quality>` | `low`, `medium`, `high`, `auto` | `auto` |
+| `-n, --count <n>` | Number of images | `1` |
+| `-m, --model <model>` | OpenAI model | `gpt-image-1` |
+
+### Environment
+
+Requires `OPENAI_API_KEY` to be set in the environment.
+
+## Instructions
+
+When the user asks you to generate or edit an image:
+
+1. **Craft a detailed prompt** from the user's request. Good prompts are specific about style, composition, colors, lighting, and mood. Expand brief requests into rich descriptions.
+
+2. **Choose appropriate settings:**
+   - Use `-q high` for logos, artwork, or when quality matters
+   - Use `-q low` for quick drafts or iterations
+   - Use `-s 1024x1536` for portraits/vertical images
+   - Use `-s 1536x1024` for landscapes/horizontal images
+   - Use `-s 1024x1024` for square images (icons, profile pictures, logos)
+
+3. **For image editing** (`-i` flag): When the user provides an existing image and wants modifications, use the edit mode. The input image must be a valid PNG file.
+
+4. **Output path**: Always use `-o` to save to a descriptive filename in the current working directory unless the user specifies otherwise.
+
+5. **After generation**: Read and display the generated image to the user using the Read tool so they can see the result. Ask if they want any changes.
+
+## Examples
+
+Generate a new image:
+```bash
+image-gen -p "A watercolor painting of a serene Japanese garden with cherry blossoms, koi pond, and a small wooden bridge, soft morning light" -q high -s 1536x1024 -o japanese-garden.png
+```
+
+Edit an existing image:
+```bash
+image-gen -p "Change the sky to a dramatic sunset with orange and purple clouds" -i photo.png -q high -o photo-sunset.png
+```
+
+Generate a logo:
+```bash
+image-gen -p "Minimalist logo for a coffee shop called 'Bean & Brew', clean lines, modern design, coffee cup icon" -q high -s 1024x1024 -o logo.png
+```