Cli Anything Blender

Name: Cli Anything Blender
Author: hkuds

hkuds/cli-anything

612 installs
46.6k repo stars
Updated August 3, 2026
hkuds/cli-anything

cli-anything-blender is a Claude Code skill for a stateful CLI that lets developers and AI agents create, edit, and render Blender 3D scenes from the terminal using JSON scene descriptions.

About

cli-anything-blender is a skill from hkuds/cli-anything for a stateful command-line interface that edits 3D scenes in Blender without opening the GUI. It follows the same CLI harness patterns as the GIMP CLI, accepts JSON scene descriptions, and generates bpy scripts for Blender rendering. Install via `pip install cli-anything-blender` with Python 3.10+ and Blender 4.2+ on the system path. Developers reach for it when agents need programmatic mesh, material, or render changes inside CI, batch jobs, or terminal-first workflows. The CLI exposes help and scene commands so agents can iterate scenes headlessly.

Stateful CLI that follows the same patterns as the GIMP CLI harness
JSON scene description format with automatic bpy script generation
Interactive REPL mode with tab-completion and command history
Supports scene new, open, save, info, profiles and json output commands
Designed for agent consumption with reliable --json flag

Cli Anything Blender by the numbers

612 all-time installs (skills.sh)
+37 installs in the week ending Aug 2, 2026 (Skillselion tracking)
Ranked #366 of 1,335 Generative Media skills by installs in the Skillselion catalog
Data as of Aug 5, 2026 (Skillselion catalog sync)

npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-blender

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/hkuds/cli-anything/cli-anything-blender.svg)](https://skillselion.com/skills/hkuds/cli-anything/cli-anything-blender)

Installs	612
repo stars	★ 46.6k
Last updated	August 3, 2026
Repository	hkuds/cli-anything ↗

How do agents edit Blender scenes from the terminal?

Let AI agents programmatically create, edit, and render 3D scenes inside Blender without leaving the terminal or agent workflow.

Who is it for?

Developers automating Blender 3D pipelines who want agents to edit scenes headlessly via a stateful CLI.

Skip if: Artists who only work inside the Blender GUI or teams without Blender 4.2+ and Python 3.10 installed locally.

When should I use this skill?

User asks to script Blender, render 3D scenes from CLI, or let an agent modify bpy scenes programmatically

What you get

JSON scene files, generated bpy scripts, and rendered Blender output from CLI commands

JSON scene files
bpy scripts
rendered 3D output

By the numbers

Requires Python 3.10+ and Blender 4.2+
Installable with `pip install cli-anything-blender`

Files

SKILL.mdMarkdownGitHub ↗

cli-anything-blender

A stateful command-line interface for 3D scene editing, following the same patterns as the GIMP CLI harness. Uses a JSON scene description format with bpy script generation for actual Blender rendering.

Installation

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

pip install cli-anything-blender

Prerequisites:

Python 3.10+
blender (>= 4.2) must be installed on your system

Usage

Basic Commands

# Show help
cli-anything-blender --help

# Start interactive REPL mode
cli-anything-blender

# Create a new scene project
cli-anything-blender scene new -o scene.blend-cli.json

# Run with JSON output (for agent consumption)
cli-anything-blender --json --project scene.blend-cli.json scene info

REPL Mode

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

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

Command Groups

Scene

Scene management commands.

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

Object Group

3D object management commands.

Command	Description
`add`	Add a 3D primitive object
`remove`	Remove an object by index
`duplicate`	Duplicate an object
`transform`	Transform an object (translate, rotate, scale)
`set`	Set an object property (name, visible, location, rotation, scale, parent)
`list`	List all objects
`get`	Get detailed info about an object

Material

Material management commands.

Command	Description
`create`	Create a new material
`assign`	Assign a material to an object
`set`	Set a material property (color, metallic, roughness, specular, alpha, etc.)
`list`	List all materials
`get`	Get detailed info about a material

Modifier Group

Modifier management commands.

Command	Description
`list-available`	List all available modifiers
`info`	Show details about a modifier
`add`	Add a modifier to an object
`remove`	Remove a modifier by index
`set`	Set a modifier parameter
`list`	List modifiers on an object

Camera

Camera management commands.

Command	Description
`add`	Add a camera to the scene
`set`	Set a camera property
`set-active`	Set the active camera
`list`	List all cameras

Light

Light management commands.

Command	Description
`add`	Add a light to the scene
`set`	Set a light property
`list`	List all lights

Animation

Animation and keyframe commands.

Command	Description
`keyframe`	Set a keyframe on an object
`remove-keyframe`	Remove a keyframe from an object
`frame-range`	Set the animation frame range
`fps`	Set the animation FPS
`list-keyframes`	List keyframes for an object

Render Group

Render settings and output commands.

Command	Description
`settings`	Configure render settings
`info`	Show current render settings
`presets`	List available render presets
`execute`	Render the scene (generates bpy script)
`script`	Generate bpy script without rendering

Preview

Real preview bundle capture and live preview session commands.

Command	Description
`preview recipes`	List available preview recipes
`preview capture`	Render a real preview bundle for the active scene
`preview latest`	Return the latest existing preview bundle
`preview live start`	Start a live preview session and publish the first bundle
`preview live push`	Publish a refreshed bundle into the live session
`preview live status`	Read current live-session state without rendering
`preview live stop`	Stop the live session without deleting artifacts

Typical bundle artifacts for recipe quick:

hero.png from real Eevee preview rendering
workbench.png from real Blender Workbench rendering

Live sessions persist:

session.json as the mutable head
immutable bundle directories
trajectory.json as append-only command-to-preview history

Viewer side:

cli-hub previews inspect <bundle-or-session>
cli-hub previews html <bundle-or-session> -o page.html
cli-hub previews watch <session-dir> --open
cli-hub previews open <bundle-or-session>

Session

Session management commands.

Command	Description
`status`	Show session status
`undo`	Undo the last operation
`redo`	Redo the last undone operation
`history`	Show undo history

Examples

Create a New Project

Create a new Blender scene project file.

cli-anything-blender scene new -o myscene.blend-cli.json
# Or with JSON output for programmatic use
cli-anything-blender --json scene new -o myscene.blend-cli.json

Interactive REPL Session

Start an interactive session with undo/redo support.

cli-anything-blender
# Enter commands interactively
# Use 'help' to see available commands
# Use 'undo' and 'redo' for history navigation

State Management

The CLI maintains session state with:

Undo/Redo: Up to 50 levels of history
Project persistence: Save/load project state as JSON
Session tracking: Track modifications and changes

Output Formats

All commands support dual output modes:

Human-readable (default): Tables, colors, formatted text
Machine-readable (--json flag): Structured JSON for agent consumption

# Human output
cli-anything-blender --project scene.blend-cli.json scene info

# JSON output for agents
cli-anything-blender --json --project scene.blend-cli.json scene info

Preview Workflow

Use Blender previews when the agent needs truthful visual checkpoints:

# List preview recipes
cli-anything-blender --project scene.blend-cli.json preview recipes

# Capture a real preview bundle
cli-anything-blender --json --project scene.blend-cli.json preview capture --recipe quick

# Start a live preview loop
cli-anything-blender --json --project scene.blend-cli.json preview live start --recipe quick --mode poll --source-poll-ms 500

# Query current live head without rendering
cli-anything-blender --json --project scene.blend-cli.json preview live status --recipe quick

For agents, preview capture --json returns bundle metadata plus artifact file paths. preview live status --json returns session metadata plus a compact trajectory_summary.

For AI Agents

When using this CLI programmatically:

1. Always use `--json` flag for parseable output 2. Check return codes - 0 for success, non-zero for errors 3. Parse stderr for error messages on failure 4. MANDATORY: Use absolute paths for all file operations (rendering, project files). Relative paths are prone to failure in background execution. 5. Use `preview capture` or `preview live ...` for visual verification instead of inferring scene quality from JSON alone 6. Read returned artifact paths such as hero.png and workbench.png; the JSON payload references files, it does not inline image bytes 7. Treat `_bundle_dir` as one snapshot only; for stable live history, use _session_dir plus _trajectory_path 8. Use `cli-hub previews ...` only to inspect/open existing previews; preview generation itself always happens through cli-anything-blender preview ...

More Information

Full documentation: See README.md in the package
Test coverage: See TEST.md in the package
Methodology: See HARNESS.md in the cli-anything-plugin

Version

1.0.0

Related skills

Remotion Best PracticesGet Remotion-specific coding guidance that prevents common video rendering mistakes when creating animated React videos.451k4.2k

Ai Video GenerationGenerate videos using 40+ AI models including Veo, Seedance, and others via inference.sh442k665

Ai Image GenerationGenerate images using 50+ AI models including FLUX, Gemini, and Replicate via inference.sh441k665

Ai Avatar VideoGenerate videos featuring AI avatars for product demos, tutorials, marketing, or explainers441k665

Remotion RenderRender videos programmatically using React components and Remotion framework441k665

Remotion RenderGenerate high-quality MP4 videos from React code using Remotion inside an AI coding agent.363k665

FAQ

What are the prerequisites for cli-anything-blender?

cli-anything-blender requires Python 3.10 or newer and Blender 4.2+ installed on the system. Install the package with `pip install cli-anything-blender`, then invoke CLI commands that emit bpy scripts from JSON scene files.

How does cli-anything-blender work?

cli-anything-blender exposes a stateful CLI modeled after the GIMP CLI harness. Developers pass JSON scene descriptions, the tool generates bpy scripts, and Blender performs the actual scene edits and rendering without manual GUI steps.

Generative Mediaautomation