cli-anything-krita

CLI harness for Krita, the professional open-source digital painting application.

Prerequisites

Krita installed on the system
Python 3.10+

Install the CLI:

cd krita/agent-harness && pip install -e .

Command Reference

Project Management

cli-anything-krita project new -n "My Art" -w 2048 -h 2048 -o project.json
cli-anything-krita project open project.json
cli-anything-krita --project project.json project save
cli-anything-krita --project project.json project info

Layer Management

cli-anything-krita -p project.json layer add "Sketch" -t paintlayer
cli-anything-krita -p project.json layer add "Colors" --opacity 200
cli-anything-krita -p project.json layer add "Group" -t grouplayer
cli-anything-krita -p project.json layer remove "Sketch"
cli-anything-krita -p project.json layer list
cli-anything-krita -p project.json layer set "Colors" opacity 180
cli-anything-krita -p project.json layer set "Colors" visible false
cli-anything-krita -p project.json layer set "Colors" blending_mode multiply

Layer types: paintlayer, grouplayer, vectorlayer, filterlayer, filllayer, clonelayer, filelayer

Filters

cli-anything-krita -p project.json filter apply blur -l "Background"
cli-anything-krita -p project.json filter apply sharpen
cli-anything-krita -p project.json filter apply levels -c '{"shadows": 10, "highlights": 240}'
cli-anything-krita filter list

Available: blur, sharpen, desaturate, levels, curves, brightness-contrast, hue-saturation, color-balance, unsharp-mask, posterize, threshold

Canvas Operations

cli-anything-krita -p project.json canvas resize -w 4096 -h 4096
cli-anything-krita -p project.json canvas resize --resolution 600
cli-anything-krita -p project.json canvas info

Export

cli-anything-krita -p project.json export render output.png -p png --overwrite
cli-anything-krita -p project.json export render output.jpg -p jpeg
cli-anything-krita -p project.json export render output.psd -p psd
cli-anything-krita -p project.json export animation ./frames/ -p png
cli-anything-krita export presets
cli-anything-krita export formats

Presets: png, png-web, jpeg, jpeg-web, jpeg-low, tiff, tiff-lzw, psd, pdf, svg, webp, gif, bmp

Session (Undo/Redo)

cli-anything-krita session undo
cli-anything-krita session redo
cli-anything-krita session history

Status

cli-anything-krita status

Agent Usage (JSON Mode)

All commands support --json for machine-readable output:

cli-anything-krita --json -p project.json project info
cli-anything-krita --json -p project.json layer list
cli-anything-krita --json status

Example Workflow

# 1. Create project
cli-anything-krita --json project new -n "Illustration" -w 3000 -h 4000 -o art.json

# 2. Set up layer stack
cli-anything-krita --json -p art.json layer add "Background" -t paintlayer
cli-anything-krita --json -p art.json layer add "Sketch" -t paintlayer --opacity 180
cli-anything-krita --json -p art.json layer add "Inking" -t paintlayer
cli-anything-krita --json -p art.json layer add "Colors" -t paintlayer
cli-anything-krita --json -p art.json layer add "Effects" -t paintlayer --opacity 128

# 3. Apply effects
cli-anything-krita --json -p art.json filter apply blur -l "Background"

# 4. Export
cli-anything-krita --json -p art.json export render final.png -p png --overwrite