cli-anything-cloudcompare

Agent-friendly command-line harness for CloudCompare, the open-source 3D point cloud and mesh processing software.

41 commands across 9 groups.

Installation

pip install cli-anything-cloudcompare

Prerequisites:

• Python 3.10+
• CloudCompare installed on your system
  • Linux (Flatpak): flatpak install flathub org.cloudcompare.CloudCompare
  • macOS/Windows: download from https://cloudcompare.org

Tested with: CloudCompare 2.13.2 (Flatpak, Linux)

Global Options

These options must be placed before the subcommand:

cli-anything-cloudcompare [--project FILE] [--json] COMMAND [ARGS]...

Option	Description
-p, --project TEXT	Path to project JSON file
--json	Output results as JSON (for agent consumption)

Command Groups

1. project, Project Management (3 commands)

project new

Create a new empty project file.

# Create a project with default name
cli-anything-cloudcompare project new -o myproject.json

# Create a project with a custom name
cli-anything-cloudcompare project new -o myproject.json -n "Bridge Survey 2024"

# JSON output for agents
cli-anything-cloudcompare --json project new -o myproject.json

Options: -o/--output TEXT (required), -n/--name TEXT

project info

Show project info and loaded entities.

cli-anything-cloudcompare --project myproject.json project info

# JSON output
cli-anything-cloudcompare --project myproject.json --json project info

project status

Show quick project status (cloud count, mesh count, last operation).

cli-anything-cloudcompare --project myproject.json project status

---

2. session, Session Management (4 commands)

session save

Save the current project state to disk.

cli-anything-cloudcompare --project myproject.json session save

session history

Show recent operation history.