Gitmap

What This Skill Does

The GitMap skill brings robust, version-control workflows to the ArcGIS ecosystem within OpenClaw. By acting as a wrapper for the gitmap-core CLI, it allows users to manage ArcGIS Online and Enterprise Portal web maps as if they were software repositories. It provides the ability to branch, diff, commit, and sync map configurations, ensuring teams can track historical changes, revert to previous versions, and manage feature development without relying on inefficient manual backups or overwriting existing work.

Installation

To begin, ensure you have the gitmap-core Python package installed in your environment via pip install gitmap-core. Next, install the skill into your OpenClaw instance by executing clawhub install openclaw/skills/skills/14-tr/gitmap. Finally, secure your connection to ArcGIS by setting the PORTAL_URL, ARCGIS_USERNAME, and ARCGIS_PASSWORD environment variables. It is highly recommended to use scoped API tokens instead of plaintext passwords to ensure account security.

Use Cases

GitMap is ideal for organizations managing complex GIS deployments. Use cases include maintaining development, staging, and production versions of a web map simultaneously, auditing accidental deletions or unintended style changes, and collaborating on layer updates without colliding with other editors. It is particularly useful for GIS administrators who require a "Git-like" audit trail for regulatory compliance and map stability.

Example Prompts

1. "List all web maps owned by 'GIS_Admin_Alpha' and show me the current status of the 'CityPlanning' repository."
2. "Create a new branch named 'emergency-response-v2' for my current map project and commit the recent layer styling changes with the message 'Updated fire station symbology'."
3. "Show me the differences between the 'main' branch and the 'emergency-response-v2' branch to verify the layer order changes."

Tips & Limitations

Always ensure your cwd (current working directory) is correctly set when invoking repository tools like gitmap_status or gitmap_commit. Since this tool interacts directly with the ArcGIS Portal, network reliability is crucial for successful pushes and pulls. Remember that GitMap does not maintain a local database; it relies solely on the gitmap-core binary to handle operations, meaning the skill is lightweight but dependent on the external dependency being present and updated. Avoid using this skill in environments where you do not have write access to the target ArcGIS Portal web maps, and always perform a gitmap_pull before starting a new work session to ensure you are operating on the latest map definition.