cli-anything-qgis
Use this skill when you need to inspect or modify QGIS projects from the terminal through the real QGIS runtime.
Requirements
- QGIS installed with
qgis_processonPATH - PyQGIS importable from the Python environment running the CLI
- Python 3.10+
Agent guidance
- Prefer
--jsonfor all machine-driven use. - For one-shot commands, pass
--project <path>when operating on an existing project. - Running
cli-anything-qgiswith no subcommand starts a stateful REPL. - Layout export is backed by real QGIS processing algorithms:
native:printlayouttopdfnative:printlayouttoimage
What this CLI covers
- create, open, save, and inspect
.qgs/.qgzprojects - create writable GeoPackage-backed vector layers
- add features via WKT geometry and typed
key=valueattributes - create print layouts and add map/label items
- export layouts to PDF or image
- inspect and run generic
qgis_processalgorithms - inspect session status and history
Command groups
project
new -o/--output [--title] [--crs]open PATHsave [PATH]infoset-crs CRS
layer
create-vector --name --geometry --crs [--field name:type ...]listinfo LAYERremove LAYER
feature
add --layer LAYER --wkt WKT [--attr key=value ...]list --layer LAYER [--limit N]
layout
create --name [--page-size] [--orientation]listinfo LAYOUTremove LAYOUTadd-map --layout LAYOUT --x --y --width --height [--extent xmin,ymin,xmax,ymax]add-label --layout LAYOUT --text TEXT --x --y --width --height [--font-size N]
export
presetspdf OUTPUT --layout LAYOUT [--dpi] [--force-vector] [--force-raster] [--georeference/--no-georeference] [--overwrite]image OUTPUT --layout LAYOUT [--dpi] [--overwrite]
process
listhelp ALGORITHM_IDrun ALGORITHM_ID [--param KEY=VALUE ...]
session
statushistory [--limit N]
Examples
Create a project and add a writable layer
bashcli-anything-qgis --json project new -o demo.qgz --title "Demo" --crs EPSG:4326 cli-anything-qgis --json --project demo.qgz layer create-vector \ --name places \ --geometry point \ --field name:string \ --field score:int
Add features and inspect them
bashcli-anything-qgis --json --project demo.qgz feature add \ --layer places \ --wkt "POINT(1 2)" \ --attr name=HQ \ --attr score=5 cli-anything-qgis --json --project demo.qgz feature list --layer places --limit 10
Create and export a layout
bashcli-anything-qgis --json --project demo.qgz layout create --name Main cli-anything-qgis --json --project demo.qgz layout add-map --layout Main --x 10 --y 20 --width 180 --height 120 cli-anything-qgis --json --project demo.qgz layout add-label --layout Main --text "Demo map" --x 10 --y 8 --width 100 --height 10 cli-anything-qgis --json --project demo.qgz export pdf output.pdf --layout Main --overwrite
Inspect or run processing algorithms
bashcli-anything-qgis --json process help native:buffer cli-anything-qgis --json --project demo.qgz process run native:buffer \ --param INPUT=/tmp/demo_data.gpkg|layername=places \ --param DISTANCE=1 \ --param SEGMENTS=8 \ --param END_CAP_STYLE=0 \ --param JOIN_STYLE=0 \ --param MITER_LIMIT=2 \ --param DISSOLVE=false \ --param OUTPUT=/tmp/buffer.geojson
REPL
bashcli-anything-qgis
Example interactive flow:
textproject new -o demo.qgz --title "Demo" layer create-vector --name places --geometry point --field name:string feature add --layer places --wkt "POINT(1 2)" --attr name=HQ layout create --name Main session status quit

