CLI Anything Samgeo
Apps & Automationcli-anything-samgeoCLI Anything Samgeo is an Agent Skill for apps & automation published in the opengeos/segment-geospatial repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
CLI harness for segment-geospatial — segment satellite/aerial imagery with SAM models from the command line
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/opengeos/segment-geospatial/blob/HEAD/agent-harness/cli_anything/samgeo/skills/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/cli-anything-samgeo, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
cli-anything-samgeo
Segment geospatial imagery (satellite, aerial, drone) using Meta AI's Segment Anything Model (SAM) family from the command line. Supports SAM v1, SAM 2, SAM 3, FastSAM, HQ-SAM, and LangSAM (text-based).
Installation
Requires Python >= 3.10.
pip install segment-geospatial[all]
cd agent-harness && pip install -e .
Syntax
cli-anything-samgeo [--json] [--project PATH] COMMAND [ARGS...]
Global flags:
--json— Machine-readable JSON output (use this for agent consumption)--project PATH— Path to project JSON file (required for project-scoped commands)
Command Groups
project — Project management
cli-anything-samgeo project new -n NAME -o PATH [-s SOURCE] [-t MODEL_TYPE] [-m MODEL_ID]
cli-anything-samgeo --project PATH project info
cli-anything-samgeo --project PATH project set-source IMAGE_PATH
cli-anything-samgeo --project PATH project history [-l LIMIT]
model — Model management
cli-anything-samgeo model list [-t TYPE]
cli-anything-samgeo model info MODEL_TYPE [-m MODEL_ID]
cli-anything-samgeo model check MODEL_TYPE
Model types: sam, sam2, sam3, fast_sam, hq_sam, text_sam
segment — Segmentation operations
cli-anything-samgeo --project PATH segment automatic -o OUTPUT [--min-size N] [--max-size N]
cli-anything-samgeo --project PATH segment points -o OUTPUT -c "x1,y1;x2,y2" -l "1,0"
cli-anything-samgeo --project PATH segment boxes -o OUTPUT -b "x1,y1,x2,y2"
cli-anything-samgeo --project PATH segment text -o OUTPUT -t "buildings"
data — Data operations
cli-anything-samgeo data info RASTER_PATH
cli-anything-samgeo data download-tiles -o OUTPUT -b "west,south,east,north" [-z ZOOM] [-s SOURCE]
cli-anything-samgeo data reproject INPUT OUTPUT [--crs EPSG:CODE]
cli-anything-samgeo data split INPUT OUT_DIR [--tile-size N] [--overlap N]
cli-anything-samgeo data basemaps [--all]
vector — Vector operations
cli-anything-samgeo vector convert RASTER_MASK OUTPUT [--simplify TOLERANCE]
cli-anything-samgeo vector info VECTOR_PATH
cli-anything-samgeo vector filter INPUT OUTPUT [--min-area N] [--max-area N]
export — Export operations
cli-anything-samgeo --project PATH export render OUTPUT [-f FORMAT] [--overwrite]
cli-anything-samgeo export formats
Formats: geotiff, cog, gpkg, shp, geojson, png
session — Session management
cli-anything-samgeo --project PATH session status
cli-anything-samgeo --project PATH session history [-l LIMIT]
Example Workflows
Satellite image segmentation pipeline
# Download tiles
cli-anything-samgeo --json data download-tiles -o image.tif -b "-122.42,37.77,-122.40,37.79" -z 17
# Create project
cli-anything-samgeo --json project new -n urban-seg -o project.json -s image.tif -t sam2
# Run automatic segmentation
cli-anything-samgeo --json --project project.json segment automatic -o masks.tif
# Convert to GeoPackage
cli-anything-samgeo --json vector convert masks.tif buildings.gpkg --simplify 1.0
# Export as GeoJSON
cli-anything-samgeo --json --project project.json export render output.geojson -f geojson --overwrite
Text-based segmentation
cli-anything-samgeo --json project new -n text-seg -o proj.json -s image.tif -t text_sam
cli-anything-samgeo --json --project proj.json segment text -o masks.tif -t "buildings"
cli-anything-samgeo --json vector convert masks.tif buildings.gpkg
Agent Guidance
- Always use
--jsonfor machine-readable output - Create a project first before running segmentation commands
- The
--projectflag must come before the command group - Check model availability with
model check TYPEbefore segmenting - Use
data infoto inspect rasters before processing - Export formats are auto-detected from file extension in
vector convert - For large images, use
--batchwithsegment automatic