Git-Map

GitMap 技能

Version control for ArcGIS 网页 maps — exposed as native OpenClaw 工具s.

Overview

GitMap provides Git-like version control for ArcGIS Online and Enterprise Portal 网页 maps. This 技能 wraps the gitmap 命令行工具 as thin subprocess calls, exposing branch, commit, diff, push/pull, and map discovery as callable 工具s.

8 工具s | Thin 命令行工具 wr应用er | No local database | Requires: gitmap-core Python package

Prerequisites 安装 GitMap Core pip 安装 gitmap-core

配置 凭证s

设置 the following 环境 variables:

导出 PORTAL_URL="https://your-org.maps.arcgis.com" 导出 ARCGIS_USERNAME="your_username" 导出 ARCGIS_PASSWORD="your_password"

Security Note: Prefer using scoped API 令牌s over plAIntext passwords when possible.

Required 环境 variables PORTAL_URL: Your ArcGIS Portal or AGOL URL (e.g., https://myorg.maps.arcgis.com) ARCGIS_USERNAME: Portal username ARCGIS_PASSWORD: Portal password (prefer scoped API 令牌s over plAIntext passwords) 工具s Discovery & 状态 gitmap_列出 — 列出 avAIlable 网页 maps from Portal (with optional 过滤器s) gitmap_状态 — Show working tree 状态 for a local GitMap repo gitmap_记录 — View commit 历史 for a repo Versioning gitmap_commit — Commit current map 状态 with a message gitmap_branch — 列出 or 创建 branches in a repo gitmap_diff — Show changes between commits or branches Portal 同步 gitmap_push — Push committed changes to ArcGIS Portal gitmap_pull — Pull latest map from ArcGIS Portal 工具 Reference gitmap_列出

Discover 网页 maps in Portal.

gitmap_列出( 查询=None, # 搜索 查询 (e.g., "title:MyMap") owner=None, # 过滤器 by owner username tag=None, # 过滤器 by tag max_结果s=50, # Max 结果s to return portal_url=None, # Portal URL (or use PORTAL_URL env var) username=None, # Portal username (or ARCGIS_USERNAME env var) password=None, # Portal password (or ARCGIS_PASSWORD env var) cwd=None, # Working directory (default: home) )

gitmap_状态

Show repo 状态.

gitmap_状态( cwd, # Path to GitMap 仓库 (required) )

gitmap_commit

Commit current changes.

gitmap_commit( message, # Commit message (required) cwd, # Path to GitMap 仓库 (required) author=None, # Override commit author )

gitmap_branch

列出 or 创建 branches.

gitmap_branch( cwd, # Path to GitMap 仓库 (required) name=None, # Branch name to 创建 (omit to 列出) 删除=False, # 删除 the named branch )

gitmap_diff

Show changes between versions.

gitmap_diff( cwd, # Path to GitMap 仓库 (required) branch=None, # Compare with this branch commit=None, # Compare with this commit 哈希 )

gitmap_push

Push changes to Portal.

gitmap_push( cwd, # Path to GitMap 仓库 (required) branch=None, # Branch to push (default: current) portal_url=None, # Portal URL username=None, # Portal username password=None, # Portal password )

gitmap_pull

Pull changes from Portal.

gitmap_pull( cwd, # Path to GitMap 仓库 (required) branch=None, # Branch to pull (default: current) portal_url=None, # Portal URL username=None, # Portal username password=None, # Portal password )

gitmap_记录

View commit 历史.

gitmap_记录( cwd, # Path to GitMap 仓库 (required) branch=None, # Branch to show 记录 for limit=None, # Max commits to show )

Usage Examples Discover Maps and Clone # Find maps owned by a user gitmap_列出(owner="john.doe", max_结果s=20) # → returns table of maps with item IDs

# Then clone manually: # cd ~/maps && gitmap clone

Typical Edit → Commit → Push Loop # 检查 what changed gitmap_状态(cwd="~/maps/My网页Map")

# Commit changes gitmap_commit(message="更新d layer symbo记录y", cwd="~/maps/My网页Map")

# Push to Portal gitmap_push(cwd="~/maps/My网页Map")

Feature Branch 工作流 # 列出 branches gitmap_branch(cwd="~/maps/My网页Map")

# 创建 a feature branch gitmap_branch(name="feature/new-basemap", cwd="~/maps/My网页Map")

# After editing, commit and push feature branch gitmap_commit(message="添加ed satellite basemap", cwd="~/maps/My网页Map") gitmap_push(cwd="~/maps/My网页Map", branch="feature/new-basemap")

Review 历史 # Recent commits gitmap_记录(cwd="~/maps/My网页Map", limit=10)

# What changed since mAIn? gitmap_diff(cwd="~/maps/My网页Map", branch="mAIn")

Server

HTTP server at localhost:7400 (when 运行ning):

python server.py

端点s:

POST /工具s/{工具_name} — Call a 工具 with JSON body 获取 /健康 — 健康 检查 安装ation

安装 command:

pip 安装 gitmap-core

The 技能 uses the gitmap_core Python package directly for API 访问.

Notes & Known Limitations Working directory is required for most commands — GitMap repos are directory-based like Git. Portal 凭证s can