CLI (abstractflow)

AbstractFlow ships a small CLI focused on: - WorkflowBundle (.flow) utilities - running the Visual Editor backend (optional; requires abstractflow[apple] or abstractflow[gpu]) - Note: WorkflowBundle commands require abstractflow[apple] or abstractflow[gpu].

Entry point: - abstractflow (declared in pyproject.toml → project.scripts) - implementation: abstractflow/cli.py

See also: ../README.md, getting-started.md, faq.md, visualflow.md, architecture.md.

WorkflowBundle (.flow)

A .flow file is a zip bundle containing: - manifest.json - flows/<flow_id>.json (one or more VisualFlow JSON documents)

Bundling semantics are shared with AbstractRuntime: - AbstractFlow CLI uses abstractruntime.workflow_bundle under the hood. - Evidence: ../abstractflow/workflow_bundle.py, ../abstractflow/cli.py.

Commands

Pack a bundle from a root VisualFlow JSON (includes referenced subflows as determined by the AbstractRuntime packer):

abstractflow bundle pack web/flows/ac-echo.json --out /tmp/ac-echo.flow

Common options (see abstractflow bundle pack --help): - --flows-dir <dir>: where to find <flow_id>.json files (defaults to the root file’s directory) - --bundle-id <id>, --bundle-version <x.y.z> - --entrypoint <flow_id> (repeatable)

Inspect a bundle manifest:

abstractflow bundle inspect /tmp/ac-echo.flow

Unpack to a directory:

abstractflow bundle unpack /tmp/ac-echo.flow --dir /tmp/ac-echo

Evidence: - Delegation to AbstractRuntime: ../abstractflow/workflow_bundle.py - CLI implementation: ../abstractflow/cli.py - Tests: ../tests/test_workflow_bundle_pack.py

Serve (Visual Editor backend)

Run the FastAPI backend used by the visual editor UI:

pip install "abstractflow[apple]"  # or abstractflow[gpu]
abstractflow serve --reload --port 8080

Notes: - This starts the backend API on /api/* (health: /api/health). - The UI can be served via npx @abstractframework/flow (see web-editor.md).

Gateway-related flags (optional): - --gateway-url http://127.0.0.1:8080 - --gateway-token <token>

Gateway resolution: - --gateway-url falls back to ABSTRACTGATEWAY_URL and defaults to http://127.0.0.1:8080 - --gateway-token falls back to ABSTRACTGATEWAY_AUTH_TOKEN - by default, startup now validates that AbstractGateway is reachable before binding the server - set ABSTRACTFLOW_ENABLE_LOCAL_RUNTIME=1 to opt into compatibility-only local-host mode and skip the gateway reachability guard

Evidence: ../abstractflow/cli.py, ../web/backend/cli.py, ../web/backend/main.py.