ignition-cli

CLI tool for the Ignition SCADA 8.3+ REST API. Built with Typer, httpx, and Pydantic.

Quick Start

# Install from PyPI
pip install ignition-cli

# Configure a gateway connection (--webdev-project enables tag read/write)
ignition-cli config add dev --url https://gateway:8043 --token "keyId:secretKey" --webdev-project mcp-connector

# Test the connection
ignition-cli config test

# Check gateway status
ignition-cli gateway status

Commands

* Tag read and write require the included SFLOW MCP Connector or a custom WebDev endpoint. Use --webdev-project to configure.

Output Formats

All list/show commands support --format / -f with: table (default), json, yaml, csv.

ignition-cli project list -f json | jq '.[].name'
ignition-cli gateway status -f yaml

Authentication

• API Token (recommended): --token "keyId:secretKey" (sent as X-Ignition-API-Token header)
• HTTP Basic Auth: --username admin --password secret
• Environment variables: IGNITION_GATEWAY_URL, IGNITION_API_TOKEN

Tag Read/Write Setup

Tag read and write are not part of the standard Ignition REST API. They require a WebDev endpoint on the gateway.

Recommended: Install the included SFLOW MCP Connector (contrib/mcp-connector.zip) on your gateway. See contrib/README.md for instructions.

Then configure your profile with the WebDev project name:

ignition-cli config add dev --url https://gateway:8043 --token "keyId:secretKey" --webdev-project mcp-connector

Or pass it per-command:

ignition-cli tag read "[default]HMI/Temperature" --webdev-project mcp-connector
ignition-cli tag write "[default]HMI/Setpoint" 75.0 --webdev-project mcp-connector

Without --webdev-project, the CLI falls back to a direct /tags/read endpoint (non-standard, requires a custom module).

Tools

Perspective View Previewer

tools/perspective-viewer.html — a self-contained HTML file that renders Perspective view JSON locally in a browser. No server or dependencies required.

• Paste JSON or drag & drop a .json file
• Load via URL parameter: ?file=path for Playwright automation
• Keyboard shortcut: Ctrl/Cmd+Enter to render
• Controls: Dark/light background, component outlines toggle, fit-to-pane scaling
• Renders: Coord/flex/column/drawing/breakpoint/tab/split containers, labels, buttons, inputs, vessel/pump/valve/motor/sensor symbols, SVG shapes (path, rect, circle, ellipse, polygon), embedded view placeholders

Documentation

Run ignition-cli --help for full usage information. See docs/usage.md for the complete reference.

Scenarios

8 production-ready automation scripts in docs/scenarios/ for tasks where the CLI provides unique value:

Development

git clone https://github.com/floriansmeyers/SFLOW-Ignition-CLI.git
cd SFLOW-Ignition-CLI
pip install -e ".[dev]"
pytest tests/

License

MIT