# How to Install the GPT-Image2 Style Library Globally via npm > Easily install the GPT-Image2 style library globally with npm. Manage skills for Codex Claude and Agents directories using the gpt-image-2-style-library CLI command. - Repository: [苍何/awesome-gpt-image-2](https://github.com/freestylefly/awesome-gpt-image-2) - Tags: how-to-guide - Published: 2026-09-01 --- **Yes, you can install the GPT-Image2 style library globally using `npm install -g gpt-image-2-style-library`, which exposes the `gpt-image-2-style-library` CLI command for managing skills across Codex, Claude, and Agents directories.** The `freestylefly/awesome-gpt-image-2` repository distributes its visual style templates and prompt engineering assets as a standalone npm module named **`gpt-image-2-style-library`**. Installing this package globally allows you to invoke the CLI from any terminal session to synchronize skill definitions into your AI coding assistant configurations. ## Global Installation Using npm To make the `gpt-image-2-style-library` command available system-wide, run the standard global install command: ```bash npm install -g gpt-image-2-style-library ``` This command works because the package's [`package.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/package.json) defines a **`bin`** entry that maps the command name to the executable script at `bin/install.mjs`. According to the source code in [`agents/skills/gpt-image-2-style-library/package.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/agents/skills/gpt-image-2-style-library/package.json), this binary declaration instructs npm to create a symlink in the global `node_modules/.bin` directory, making the CLI accessible from any working directory. ## How the Global CLI Works Once installed globally, the CLI entry point executes `agents/skills/gpt-image-2-style-library/bin/install.mjs`. This Node.js module handles two primary operations: - **`install`**: Copies library assets (templates, style definitions, and references) into target skill folders for the first time - **`sync`**: Overwrites existing installations with the latest version from the package The script automatically detects and writes to three standard configuration directories: - `~/.codex/skills` for OpenAI Codex - `~/.claude/skills` for Claude Code - `~/.agents/skills` for general AI agents ## Installing Skills to Target Directories After global installation, you can manage your GPT-Image2 styles using the following commands: ```bash # Install the skill into all supported directories gpt-image-2-style-library install all # Install only into the Claude-specific skill folder gpt-image-2-style-library install claude-code # Update (overwrite) an existing Codex installation gpt-image-2-style-library sync codex ``` These commands read the bundled assets from [`agents/skills/gpt-image-2-style-library/references/style-library.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/agents/skills/gpt-image-2-style-library/references/style-library.md) and deploy them into the respective agent skill directories, making the visual style templates immediately available to your AI assistants. ## Local Installation as an Alternative If you prefer not to install globally or need to version-lock the library per project, use a local development installation: ```bash npm install --save-dev gpt-image-2-style-library ``` Invoke the CLI using `npx` without affecting global scope: ```bash npx gpt-image-2-style-library install all ``` Both approaches provide identical functionality; the only difference is whether the binary resides in your project's `node_modules/.bin` or the global npm prefix. ## Key Source Files Understanding these implementation files confirms the library's behavior and installation mechanics: - **[`agents/skills/gpt-image-2-style-library/package.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/agents/skills/gpt-image-2-style-library/package.json)**: Declares the npm package metadata, version constraints, and the critical `bin` field that enables global CLI access - **`agents/skills/gpt-image-2-style-library/bin/install.mjs`**: Implements the installation logic, path resolution for target directories (`~/.codex/skills`, etc.), and the `install`/`sync` command handlers - **[`agents/skills/gpt-image-2-style-library/SKILL.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/agents/skills/gpt-image-2-style-library/SKILL.md)**: Documents the skill's workflow, maintenance commands, and integration patterns - **[`agents/skills/gpt-image-2-style-library/references/style-library.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/agents/skills/gpt-image-2-style-library/references/style-library.md)**: Serves as the auto-generated index of all visual style templates that the CLI copies into target environments ## Summary - **Global installation** requires `npm install -g gpt-image-2-style-library` and enables the `gpt-image-2-style-library` command system-wide - The **binary entry point** at `bin/install.mjs` handles copying assets to `~/.codex/skills`, `~/.claude/skills`, and `~/.agents/skills` - **Local installation** via `--save-dev` works with `npx` for project-scoped usage without global pollution - The CLI supports **`install`** (initial deployment) and **`sync`** (overwrite/update) operations for managing style templates ## Frequently Asked Questions ### What is the exact npm package name for the GPT-Image2 style library? The package is published to npm as **`gpt-image-2-style-library`**. You can verify this name in the [`agents/skills/gpt-image-2-style-library/package.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/agents/skills/gpt-image-2-style-library/package.json) file within the `freestylefly/awesome-gpt-image-2` repository, which defines the module name, version, and binary entry points. ### Where does the CLI install the skill files on my system? The installer copies templates and style definitions into three specific directories within your home folder: `~/.codex/skills` for OpenAI Codex, `~/.claude/skills` for Claude Code, and `~/.agents/skills` for general agent configurations. These paths are hardcoded in `agents/skills/gpt-image-2-style-library/bin/install.mjs`. ### Can I use the GPT-Image2 style library without installing it globally? Yes. Run `npm install --save-dev gpt-image-2-style-library` in your project directory, then prefix commands with `npx`, such as `npx gpt-image-2-style-library install all`. This executes the binary from your local `node_modules` without requiring global permissions or polluting the system PATH. ### What is the difference between the `install` and `sync` commands? The **`install`** command performs an initial copy of the style library assets into the target skill folders, while the **`sync`** command overwrites existing files with the latest version bundled in the npm package. Use `sync` when updating to a newer version of the library or when you want to reset local modifications to the standard templates.