CLI
Manage workflows with the fragno-wf CLI.
The fragno-wf CLI talks to the Workflows fragment HTTP API to list workflows, inspect instances,
and send management actions.
Install
npm install -g @fragno-dev/fragno-wfOr run it without installing:
npx @fragno-dev/fragno-wf --helpBase URL
Provide the full fragment base URL:
fragno-wf workflows list --base-url https://host.example.com/api/workflowsYou can also set a default:
export FRAGNO_WF_BASE_URL=https://host.example.com/api/workflowsAuth headers
Pass headers with -H (repeatable) or via FRAGNO_WF_HEADERS:
fragno-wf workflows list \
--base-url https://host.example.com/api/workflows \
-H "Authorization: Bearer $TOKEN" \
-H "X-Env: staging"export FRAGNO_WF_HEADERS="Authorization: Bearer $TOKEN;X-Env: staging"Common commands
fragno-wf workflows list -b https://host.example.com/api/workflows
fragno-wf instances list -b https://host.example.com/api/workflows -w approvals --status running
fragno-wf instances get -b https://host.example.com/api/workflows -w approvals -i inst_123
fragno-wf instances history -b https://host.example.com/api/workflows -w approvals -i inst_123
fragno-wf instances logs -b https://host.example.com/api/workflows -w approvals -i inst_123 --follow
fragno-wf instances create -b https://host.example.com/api/workflows -w approvals \
--params '{"requestId":"req_1","amount":125}'
fragno-wf instances pause -b https://host.example.com/api/workflows -w approvals -i inst_123
fragno-wf instances send-event -b https://host.example.com/api/workflows -w approvals \
-i inst_123 -t approval --payload '{"approved":true}'Options
-b, --base-url: workflow fragment base URL (orFRAGNO_WF_BASE_URL)-H, --header: extra HTTP header, repeatable (orFRAGNO_WF_HEADERS)--timeout: request timeout in ms (orFRAGNO_WF_TIMEOUT_MS, default 15000)--retries: retry count for network/5xx/429 (orFRAGNO_WF_RETRIES, default 2)--retry-delay: delay between retries in ms (orFRAGNO_WF_RETRY_DELAY_MS, default 500)
For the full command tree, run fragno-wf --help.