`shipmates-svgflow`

Deprecated alias for `shipmates-diagram` — svgflow's flow diagram is now a kind of the more general diagram tool.

Shipmates: Deprecated alias for the `diagram` tool. svgflow's flow diagram is now the default `kind` of `diagram`, which also renders PNG and animated GIF and adds a sequence kind. This shim forwards to diagram.py so nothing that already reaches for svgflow breaks; reach for `diagram` instead. Never a slash command.

What it does

svgflow has become diagram (ADR 0001): the box-and-arrow flow diagram it drew is now the default kind of a more general tool that keeps svgflow's theme-exact, byte-for-byte deterministic SVG and adds PNG and animated-GIF output, a sequence kind, and intent routing. Reach for diagram instead.

For one release svgflow.py is kept as a thin deprecation shim: it prints a one-line deprecation notice and forwards every argument, unchanged, to diagram.py, so nothing that already reaches for svgflow breaks. The default kind is flow, so an existing svgflow spec renders exactly the same through the alias.

Examples

A few things shipmates-svgflow can produce, each from a small spec of its own.

A vertical flow diagram titled 'CI pipeline': Build, Test and Deploy boxes joined by downward terracotta arrows labelled 'on push' and 'green', with a back-edge from Test to Build labelled 'red → retry'. — A CI pipeline as a column — the same flow diagram, now the default kind of `diagram`.

A left-to-right flow diagram titled 'Request flow': Client, API gateway, Service and Database boxes joined by terracotta arrows labelled 'HTTPS', 'authz' and 'query', with a return edge from Service to Client labelled '200 JSON'. — A request path as a row — client through gateway and service to the database, and the response back.

A vertical state diagram titled 'Order state machine': Pending, Paid, Shipped and Delivered states joined by terracotta arrows, a back-edge from Shipped to Pending labelled 'cancelled', and a self-loop on Delivered labelled 're-notify'. — An order state machine — the forward path plus a cancelled transition and a self-loop, all auto-routed.

How the crew reach for it

Nothing to add — installing the diagram tool is what you want. This alias exists only so an existing python3 svgflow.py --spec spec.json --out flow.svg call keeps working while callers migrate; it forwards to diagram.py and emits a deprecation notice on stderr.

Switch to diagram: shipmates install --harness <name> --with-tools diagram, then python3 diagram.py --spec spec.json --out flow.svg (or .png / .gif).

Reference

Name: shipmates-svgflow
Description: Shipmates: Deprecated alias for the `diagram` tool. svgflow's flow diagram is now the default `kind` of `diagram`, which also renders PNG and animated GIF and adds a sequence kind. This shim forwards to diagram.py so nothing that already reaches for svgflow breaks; reach for `diagram` instead. Never a slash command.
Bundled files: svgflow.py
Install: shipmates install --harness <name> --with-tools shipmates-svgflow

Where this lives

This page is generated from toolbox/shipmates-svgflow/tool.md. Opt in at install with --with-tools shipmates-svgflow and the installer copies the tool — instructions and bundled files — into the harness's skills tree.

View toolbox/shipmates-svgflow/tool.md on GitHub

Other tools

All tools