cli-anything-inkscape

A stateful command-line interface for vector graphics editing, following the same patterns as the GIMP and Blender CLI harnesses. Directly manipulates SVG (XML) documents with a JSON project format for state tracking.

Installation

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

pip install cli-anything-inkscape

Prerequisites:

• Python 3.10+
• inkscape must be installed on your system

Usage

Basic Commands

# Show help
cli-anything-inkscape --help

# Start interactive REPL mode
cli-anything-inkscape

# Create a new document
cli-anything-inkscape document new -o project.json

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

REPL Mode

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

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

You can also start the REPL with a nonexistent project path. The CLI now seeds a new in-memory document instead of failing immediately:

cli-anything-inkscape --project /abs/path/new-title.inkscape-cli.json

Command Groups

Document

Document management commands.

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

Shape

Shape management commands.