An advanced command-line interface for Google Gemini image generation, editing, and profile-based workflow management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pixr
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install pixr using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Pixr CLI?
Pixr CLI is a powerful tool designed to bridge the gap between local development workflows and the Google Gemini image generation ecosystem. As part of the ecosystem of Openclaw Skills, it provides a structured way to handle image creation, text-guided editing, and visual variations directly from the terminal or through an AI agent.
By centralizing configurations in the home directory, it ensures that your prompts, styles, and model preferences remain consistent across different projects and sessions. This skill empowers users to automate complex visual tasks while maintaining granular control over model parameters and local file storage.
Pixr CLI Use Cases
- Generating high-quality images from text prompts using Gemini models.
- Performing text-guided edits on existing local images via command line.
- Creating multiple visual variations based on a reference image for rapid prototyping.
- Managing project-specific profiles to isolate different creative styles and save directories.
- Automating batch image processing or directory-based asset management within development pipelines.
How Pixr CLI Works
- Initialize or inspect the configuration using the pixr config command to establish global defaults for models and output directories.
- Define persistent styles and instructions in markdown files within the ~/.pixr directory to guide the AI creative process.
- Execute generation, editing, or variation commands which the CLI processes by communicating with the Gemini API.
- Apply local post-processing, including format conversion (to webp, jpg, etc.) and aspect-ratio-aware resizing based on user specifications.
- Organize resulting assets into profile-specific folders or the default asset library for streamlined retrieval.
Pixr CLI Setup
To get started with this skill, ensure you have the CLI available in your environment:
# Check global installation
pixr help
# Or run via npm if working within the local repository
npm run pixr -- help
# Configure your preferred AI model
pixr model <model-name>
# Set a default directory for all generated images
pixr save-dir --set "/path/to/your/assets"
# Initialize a new creative profile
pixr profile init my-project
Pixr CLI Data Schema & Taxonomy
| Component | Location / Format | Description |
|---|---|---|
| Config File | ~/.pixr/config.json |
Stores global settings like default models and output paths. |
| Profiles | ~/.pixr/profiles/ |
Sub-directories containing unique configs and assets for specific projects. |
| Global Style | ~/.pixr/STYLE.md |
A markdown file defining the persistent artistic style for the agent. |
| Assets | ~/.pixr/assets |
Local storage for reference images; tracks the 3 most recently modified files. |
| Prompt Templates | ~/.pixr/prompts/ |
Command-specific markdown files used to structure AI requests. |
Pixr CLI Advanced Features
- Profile-based isolation allows for switching between different creative contexts and API settings instantly.
- Native support for local image format conversion including PNG, JPG, and WEBP.
- Intelligent resizing logic that preserves aspect ratios when only one dimension is provided.
- Machine-readable JSON output mode for all commands, making it perfect for integration into larger Openclaw Skills automation chains.
- Interactive model selection and live configuration validation to prevent API errors during generation.
SKILL.md
Loading
Related Openclaw Skills
Instagram Video Editor App
An AI-powered video editing skill that transforms raw footage into polished, platform-ready Instagram content using simple text commands.
Video Maker Free for YouTube
An AI-powered video editing agent that transforms raw footage into polished, YouTube-ready 1080p videos through natural language commands.
AI Video Editor No Login
An AI-powered video editing skill that transforms raw clips into polished 1080p MP4 files through simple chat commands without requiring an account.
Text to Video Hindi
An AI-powered tool for converting Hindi text and scripts into professional videos with visuals and voiceovers.
Image to Video Open Source
A powerful AI-driven skill that converts static images into professional 1080p video clips using cloud-based GPU rendering.
Video Editor with AI Online
An AI-powered video editing skill that converts raw clips into 1080p polished videos using natural language commands and cloud-based GPU rendering.
Featured*
