gitmap

name	gitmap
description	Git-Map

GitMap Skill

Version control for ArcGIS web maps — exposed as native OpenClaw tools.

Overview

GitMap provides Git-like version control for ArcGIS Online and Enterprise Portal web maps. This skill wraps the gitmap CLI as thin subprocess calls, exposing branch, commit, diff, push/pull, and map discovery as callable tools.

8 tools | Thin CLI wrapper | No local database | Requires: gitmap-core Python package

---

Prerequisites

Install GitMap Core

pip install gitmap-core

Configure Credentials

Set the following environment variables:

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

Security Note: Prefer using scoped API tokens over plaintext passwords when possible.

---

Required environment 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 tokens over plaintext passwords)

---

Tools

Discovery & Status

• gitmap_list — List available web maps from Portal (with optional filters)
• gitmap_status — Show working tree status for a local GitMap repo
• gitmap_log — View commit history for a repo

Versioning

• gitmap_commit — Commit current map state with a message
• gitmap_branch — List or create branches in a repo
• gitmap_diff — Show changes between commits or branches

Portal Sync

• gitmap_push — Push committed changes to ArcGIS Portal
• gitmap_pull — Pull latest map from ArcGIS Portal

---

Tool Reference

gitmap_list

Discover web maps in Portal.

gitmap_list(
    query=None,        # Search query (e.g., "title:MyMap")
    owner=None,        # Filter by owner username
    tag=None,          # Filter by tag
    max_results=50,    # Max results 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_status

Show repo status.

gitmap_status(
    cwd,               # Path to GitMap repository (required)
)

gitmap_commit

Commit current changes.

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

gitmap_branch

List or create branches.

gitmap_branch(
    cwd,               # Path to GitMap repository (required)
    name=None,         # Branch name to create (omit to list)
    delete=False,      # Delete the named branch
)

gitmap_diff

Show changes between versions.

gitmap_diff(
    cwd,               # Path to GitMap repository (required)
    branch=None,       # Compare with this branch
    commit=None,       # Compare with this commit hash
)

gitmap_push

Push changes to Portal.

gitmap_push(
    cwd,               # Path to GitMap repository (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 repository (required)
    branch=None,       # Branch to pull (default: current)
    portal_url=None,   # Portal URL
    username=None,     # Portal username
    password=None,     # Portal password
)

gitmap_log

View commit history.

gitmap_log(
    cwd,               # Path to GitMap repository (required)
    branch=None,       # Branch to show log for
    limit=None,        # Max commits to show
)

---

Usage Examples

Discover Maps and Clone

# Find maps owned by a user
gitmap_list(owner="john.doe", max_results=20)
# → returns table of maps with item IDs

# Then clone manually:
# cd ~/maps && gitmap clone <item_id>

Typical Edit → Commit → Push Loop

# Check what changed
gitmap_status(cwd="~/maps/MyWebMap")

# Commit changes
gitmap_commit(message="Updated layer symbology", cwd="~/maps/MyWebMap")

# Push to Portal
gitmap_push(cwd="~/maps/MyWebMap")

Feature Branch Workflow

# List branches
gitmap_branch(cwd="~/maps/MyWebMap")

# Create a feature branch
gitmap_branch(name="feature/new-basemap", cwd="~/maps/MyWebMap")

# After editing, commit and push feature branch
gitmap_commit(message="Added satellite basemap", cwd="~/maps/MyWebMap")
gitmap_push(cwd="~/maps/MyWebMap", branch="feature/new-basemap")

Review History

# Recent commits
gitmap_log(cwd="~/maps/MyWebMap", limit=10)

# What changed since main?
gitmap_diff(cwd="~/maps/MyWebMap", branch="main")

---

Server

HTTP server at localhost:7400 (when running):

python server.py

Endpoints:

• POST /tools/{tool_name} — Call a tool with JSON body
• GET /health — Health check

---

Installation

Install command:

pip install gitmap-core

The skill uses the gitmap_core Python package directly for API access.

---

Notes & Known Limitations

• Working directory is required for most commands — GitMap repos are directory-based like Git.
• Portal credentials can be passed per-call or via environment variables (PORTAL_URL, ARCGIS_USERNAME, ARCGIS_PASSWORD).
• gitmap list doesn't require a local repo — it queries Portal directly.
• Output is raw CLI text — parsed lightly for structured responses where possible. NOT implement clone, init,- This skill does merge, checkout, l, or setupsm, context-repos — call the CLI directly for those.

---

Related

• GitMap Project: https://github.com/14-TR/gitmap