acugis

ACUGIS CLI

Command-line interface for the AcuGIS geospatial platform. Manage datasets, maps, dashboards, reports, databases, ETL pipelines, and synchronization projects from the terminal.

Authentication uses Central username/password login (session cookie) or a personal access token (Authorization: Bearer). Password login persists the shared acugis_session cookie — the same model as the browser. Token login is intended for CI/CD and non-interactive scripts.

Installation

Development install

cd cli
python3 -m venv .venv

# Linux / macOS
source .venv/bin/activate

# Windows
.venv\Scripts\activate

pip install -e .

This installs the acugis command into your virtual environment.

Verify

acugis version
acugis --help

Quick start

acugis login https://app.acugis.cloud
acugis whoami
acugis catalog
acugis datasets list
acugis datasets preview bees

Token login (CI / automation)

Create a token in Central under Account → Personal Access Tokens, then:

acugis login https://app.acugis.cloud --token agp_xxxxxxxx
acugis whoami

Or without writing credentials to disk:

export ACUGIS_URL=https://app.acugis.cloud
export ACUGIS_TOKEN=agp_xxxxxxxx
acugis whoami
acugis catalog

Configuration

Login writes local session files under ~/.config/acugis/:

Example config.json after password login:

{
  "base_url": "https://app.acugis.cloud"
}

Example after token login:

{
  "base_url": "https://app.acugis.cloud",
  "token": "agp_xxxxxxxx"
}

Session cookies or a saved token are reused across CLI restarts until they expire, are revoked, or you run acugis logout.

Shell completion

Typer provides shell completion for Bash, Zsh, Fish, and PowerShell.

Install completion for your shell:

acugis --install-completion

Show the completion script without installing:

acugis --show-completion

Restart your shell after installing completion.

Command reference

Authentication

acugis login https://app.acugis.cloud
acugis login https://app.acugis.cloud --token agp_xxxxxxxx
acugis whoami
acugis whoami --json
acugis logout

Catalog

acugis catalog
acugis catalog --json

Datasets (Geovault)

acugis datasets list
acugis datasets list --json
acugis datasets preview bees
acugis datasets preview bees --version 2
acugis datasets preview bees --json

Maps (QGIS Publish Service)

acugis maps list
acugis maps list --json
acugis maps info nyc
acugis maps open nyc
acugis maps layers nyc
acugis maps versions nyc
acugis maps publish project.zip
acugis maps publish project.qgz --title "City Infrastructure"
acugis maps publish project.zip --update nyc --open

Dashboards (Dashboard Service)

Reports (Jasper)

Databases (PostGIS Service)

GeoETL

Sync (GeoSync)

Version

acugis version

JSON output

Commands that return data support --json for machine-readable output:

acugis whoami --json
acugis catalog --json
acugis datasets list --json
acugis datasets preview bees --json
acugis maps list --json
acugis maps info nyc --json
acugis maps layers nyc --json

Project layout

acugis/
  cli.py              Main application entry point
  auth.py             Login, logout, whoami
  catalog.py          Platform catalog
  session.py          Config, cookies, HTTP helpers
  util.py             Output formatting
  services/           Per-service command groups
pyproject.toml        Package metadata and entry points
README.md
LICENSE

License

MIT — see LICENSE.