Quick Start & CLI Reference

Local Folder Sync & Compile

Run git2iris against a local directory containing ObjectScript files (.cls, .mac, .inc, .dfi, .gbl):

./git2iris \
  -dir ./examples/sample_cls \
  -endpoint http://192.168.1.200:52773/api/atelier \
  -user _SYSTEM \
  -pass intersystems \
  -ns USER

---

GitLab API Sync & Compile

Sync an entire GitLab repository directly into InterSystems IRIS:

./git2iris \
  -gitlab-url https://gitlab.com \
  -gitlab-project ron-sween/xsiri \
  -gitlab-token glpat-xxxxxxxxxxxx \
  -gitlab-ref main \
  -endpoint http://192.168.1.200:52773/api/atelier \
  -user _SYSTEM \
  -pass intersystems \
  -ns USER

To sync a specific subfolder or path within the GitLab repository, use the -gitlab-path flag:

./git2iris \
  -gitlab-url https://gitlab.com \
  -gitlab-project ron-sween/xsiri \
  -gitlab-token glpat-xxxxxxxxxxxx \
  -gitlab-ref main \
  -gitlab-path purple-int/src \
  -endpoint http://192.168.1.200:52773/api/atelier \
  -user _SYSTEM \
  -pass intersystems \
  -ns USER

---

Command-Line Options

Flag	Default	Description
-endpoint, -atelier-url	http://192.168.1.200:52773/api/atelier	InterSystems Atelier REST API URL
-user	_SYSTEM	IRIS Atelier username
-pass	intersystems	IRIS Atelier password
-ns	USER	Target IRIS namespace
-dir, -d	""	Local directory containing ObjectScript files
-gitlab-url	https://gitlab.com	Base URL of GitLab instance
-gitlab-project	""	GitLab Project ID (e.g. 12345) or path (group/repo)
-gitlab-token	$GITLAB_TOKEN	Personal/Job access token for GitLab API
-gitlab-ref	main	Git branch, tag, or commit SHA
-gitlab-path	""	Optional subpath inside repository to scan
-compile	true	Compile uploaded documents on IRIS
-compile-flags	ck	Atelier compilation flags (e.g., ck, cuk, d)
-concurrency	4	Number of parallel upload workers
-dry-run	false	Preview document mappings without uploading
-v	false	Enable verbose output
-version	false	Display version information