img

🖼️ Image Agency

Image generation for Claude Code, Codex, and the terminal. Built for brand and agency teams who need on-brand assets across one or many client projects.

Calls one of two providers, with no automatic fallback:

• OpenAI gpt-image-2
• Google gemini-3.1-flash-image-preview

The plugin also ships a small attributed prompt-recipe index generated from dev-only research checkouts. Claude and Codex can query it with img recipes before writing the final provider prompt.

---

Contents

• Install
• Setup
• Use cases
• CLI reference
• Configuration
• Troubleshooting
• Uninstall
• Develop and contribute
• License

---

Install

The recommended install is CLI-first. It gives you a real img terminal command, then uses that command to install the native Claude Code and Codex marketplace plugins when those CLIs are present.

1. Recommended: npm CLI + agent plugins

npx -y @nyldn.sh/install-img

The installer installs the img CLI, opens the interactive setup control panel, then registers native Claude Code and Codex plugins.

If you prefer to run the transparent npm steps yourself:

npm install -g @nyldn.sh/img
img setup
img install

The img package still bootstraps first-run user setup files non-interactively during npm install, but it does not open the control panel inside npm because npm postinstall TTYs are unreliable across terminals. It also does not scan the current project during npm install; project discovery runs only from explicit setup commands.

If you skipped lifecycle scripts, img setup creates the same user files.

If you need to install directly from source instead of npm registry:

npm install -g https://github.com/nyldn/img.git

img install detects Claude Code and Codex, adds the shared nyldn-plugins marketplace, installs what each CLI can install non-interactively, removes the legacy generated Claude user /img alias if present, and opens the interactive setup panel on first install when a real terminal is available.

Use explicit targets when needed:

img install claude
img install codex
img install --no-setup

After install, run the setup panel any time:

img setup

2. Claude Code marketplace-only

Run this in your terminal, not inside a Claude Code session:

claude plugin marketplace add https://github.com/nyldn/plugins.git
claude plugin install img@nyldn-plugins

nyldn-plugins is a shared marketplace catalog at https://github.com/nyldn/plugins.git, and it makes both plugins available:

claude plugin install img@nyldn-plugins

Marketplace-only installs provide the bundled plugin binary and namespaced commands. For the best local setup experience, use the npm flow above so img setup is available on $PATH.

Then start or restart Claude Code and run a normal image request:

/img a clean app icon for a savings tracker

If the provider key is missing, /img creates user setup files and tells you the exact terminal command to save the key in macOS Keychain before you re-run the same request. The key is read by the local img binary, not by Claude.

The plugin calls its bundled bin/img; a global CLI install is not required for Claude marketplace commands.

Command	What it does
/img <natural language>	Default generation. OpenAI gpt-image-2.
/img setup	Pre-create or refresh setup files and health checks.
/img:setup	Pre-create or refresh setup files and health checks.
/img:openai <prompt>	Force OpenAI.
/img:gemini <prompt>	Force Gemini.
/img:edit --input <path> [--provider openai|gemini] <prompt>	Edit/restyle a reference image.

Claude exposes the marketplace plugin's /img command directly. The namespaced /img:* forms remain available for explicit setup, provider, and edit flows.

3. Codex marketplace-only

codex plugin marketplace add https://github.com/nyldn/plugins.git

nyldn-plugins is the same shared catalog used by Claude. In Codex it lists claude-octopus and img.

Restart Codex, open /plugins, then install or enable img. Use it as a natural-language skill:

$img create three on-brand article header images for this project

If you want to type img ... directly in a terminal or in Codex shell commands, use the npm install from the recommended path.

4. Local development

Install from source:

git clone https://github.com/nyldn/img.git
cd img
npm link
npm install
npm test
claude --plugin-dir "$(pwd)"

---

Setup