cli-anything-gimp

A stateful command-line interface for image editing, built on Pillow. Designed for AI agents and power users who need to create and manipulate images without a GUI.

Installation

This CLI is installed as part of the cli-anything-gimp package:

pip install cli-anything-gimp

Prerequisites:

• Python 3.10+
• gimp is recommended for native batch rendering, but layered compositions can still render through the built-in Pillow path when GIMP is unavailable or when deferred draw operations are present

Usage

Basic Commands

# Show help
cli-anything-gimp --help

# Start interactive REPL mode
cli-anything-gimp

# Create a new project
cli-anything-gimp project new -o project.json

# Run with JSON output (for agent consumption)
cli-anything-gimp --json project info -p project.json

REPL Mode

When invoked without a subcommand, the CLI enters an interactive REPL session:

cli-anything-gimp
# Enter commands interactively with tab-completion and history

Command Groups

Project

Project management commands.

Command	Description
new	Create a new project
open	Open an existing project
save	Save the current project
info	Show project information
profiles	List available canvas profiles
json	Print raw project JSON

Layer

Layer management commands.

Command	Description
new	Create a new blank layer
add-from-file	Add a layer from an image file
list	List all layers
remove	Remove a layer by index
duplicate	Duplicate a layer
move	Move a layer to a new position
set	Set a layer property (name, opacity, visible, mode, offset_x, offset_y); negative offsets are accepted naturally
flatten	Flatten all visible layers
merge-down	Merge a layer with the one below it

Canvas

Canvas operations.