imgcmd icon

imgcmd

imgcmd is a Node.js CLI that generates real image files on disk using Gemini AI. It is aimed at developers and AI-assisted coding workflows that need local image assets instead of chat-generated SVG or Base64 output.

imgcmd

Overview

imgcmd is a Node.js command-line tool that generates real image files on disk using Gemini AI. The site presents it as an alternative to chat-based image workarounds such as fragile SVG output or Base64-encoded image data.

The product is built for terminal-first and agentic coding workflows. It is positioned to help developers and AI editors create image assets directly into a project directory, with examples that show files being written locally and kept organized in the codebase.

Features

Real image files on disk

Generates actual image files on disk rather than returning SVG snippets or Base64 strings, which fits workflows that need assets saved into a repository.

Terminal-based CLI

Runs from the terminal as a Node.js CLI, with an install command shown on the site and a workflow centered on local execution.

Editor workflow support

Integrates with agentic editors such as Cursor and VS Code so an AI assistant can create image assets during the coding flow.

Local-only execution

Keeps API keys on the local machine and performs execution in the user’s terminal instead of through an intermediary service.

Model selection controls

Supports Gemini 2.5 and 3.1 Flash out of the box, with the `IMGCMD_FORCE_MODEL` flag for enforcing a preferred model.

Language and directory handling

Automatically detects EN/PT and organizes prompts with directory-aware behavior, according to the homepage copy.

Use Cases

  • Create project assets in place

    A developer can generate a background, logo, or other asset directly inside a repository instead of copying SVG code or decoding Base64 output by hand.

  • Add images during AI coding workflows

    An AI-assisted coding session can produce an image file as part of the normal editing flow, which suits teams using Cursor or VS Code for agentic tasks.

  • Standardize model usage

    A user who wants the model choice standardized across a team can set the `IMGCMD_FORCE_MODEL` flag so the same Gemini model is used consistently.

  • Work across supported locales

    A multilingual team working in English or Portuguese can use the tool’s automatic language detection and still keep prompts organized in local project folders.

  • Keep generation local

    A security-conscious developer can keep the image-generation step on their own machine while retaining local control over API keys and execution.

Pros and Cons

Pros

  • Generates actual files on disk instead of relying on SVG or Base64 output.
  • Works from the terminal, which fits developer and agentic IDE workflows.
  • Keeps API keys local to the machine.
  • Supports Gemini 2.5 and 3.1 Flash out of the box.
  • Provides a command-based way to create editor rules for tools such as Cursor.

Cons

  • The public pages do not document the full CLI surface area, available commands, or output configuration in detail.
  • Pricing information is not shown in the provided page text, so the plan structure is unclear from the source.
  • The site gives only limited setup guidance beyond the install command and an example rule workflow.

FAQ

What does imgcmd do?

imgcmd is a Node.js CLI that generates real image files on disk using Gemini AI. The homepage positions it as a way to avoid chat-generated SVG or Base64 workarounds.

How does imgcmd fit into editor-based workflows?

The site says it integrates with modern agentic IDEs like Cursor and VS Code, and it can create AI rules with a command such as `imgcmd --create-rule cursor`. The public page does not provide deeper setup steps.

Where are generated images saved?

The homepage says generated images are saved directly to disk in the project directory, with an example that writes a file such as `/assets/dashboard-bg.png`.

Which models does imgcmd support?

The site states that imgcmd supports Gemini 2.5 and 3.1 Flash out of the box and that the `IMGCMD_FORCE_MODEL` flag can be used to enforce a preferred model.

Does imgcmd send API keys through a server?

The page emphasizes that API keys stay on the user's machine and that execution happens locally in the terminal. The site does not publish additional security or privacy details.

Quick Facts

Category
Developer Tool
Platform
Node.js CLI
Primary use
Generating image files on disk
Model provider
Gemini AI
Source domain
imgcmd.com
Editor fit
Cursor and VS Code mentioned