alib8b8/dsh-plugin-aflare
Workflow tools for the local aflare binary: generate, validate and run local-first deterministic YAML workflow DAGs (WAL crash recovery, Saga compensation) through the local aflare binary, with 300+ templates built in.
dsh-plugin-aflare exposes aflare workflow tools as native DSH tools: aflare_version (installed aflare version), aflare_generate (create workflow YAML from a description; optional ai: true for LLM generation), aflare_validate (validate a workflow YAML), aflare_run (execute a workflow YAML and return the output), aflare_template_list (list built-in templates) and aflare_template_run (run a template by id). Every tool spawns the local aflare binary with execFile — arguments are passed as argv, never through a shell, so tool parameters cannot inject commands — keeping the same local-first guarantee aflare itself makes. Output is truncated at 256 KB to protect model context, and aflare's own protections (path validation, safe mode, policy engine) apply to every run; set AFLARE_SAFE_MODE=1 in the DSH process environment for untrusted workflows.
Install
dsh plugin --profile web add @alib8b8/dsh-plugin-aflarenpm @alib8b8/dsh-plugin-aflare 0.1.0 verified 2026-09-02 (npm repository field points at the aflare monorepo; this repo is its distribution mirror per the README — development happens in aflare/integrations/dsh-plugin). One-line install into DSH: dsh plugin --profile web add @alib8b8/dsh-plugin-aflare (the github:alib8b8/dsh-plugin-aflare spec works too); the package declares dsh.bundle.patch so DSH registers the plugin entry automatically — restart dsh web and the tools are live, no profile editing. Prerequisite: install the local aflare CLI binary first (one line per the aflare README; the plugin drives it, so nothing leaves your machine). License AGPL-3.0-or-later (same as aflare).
Compatibility
DSH web profile (Cordis plugin); requires the local aflare binary; env AFLARE_BIN (default aflare) and AFLARE_TIMEOUT_MS (default 300000); execFile invocation, never a shell.
Details
- Repo: alib8b8/dsh-plugin-aflare
- Category: Workflow & Automation
- Stars: 1
- Version: npm @alib8b8/dsh-plugin-aflare 0.1.0
- Last push: 2026-08-15
- First seen: 2026-08-15
Recent updates
6 aflare tools (version/generate/validate/run/template_list/template_run); execFile-only invocation (no shell injection); 256 KB output cap; local-first; auto bundle registration.
FAQ
- What does the plugin need installed?
- The local aflare CLI binary — the plugin drives it with execFile, so all workflow generation, validation and execution happen on your machine with nothing leaving it.
- How do tools stay shell-safe?
- Every invocation uses execFile with arguments passed as argv — never through a shell — so tool parameters cannot inject commands.
- Where does development happen?
- This repository is the distribution mirror of aflare/integrations/dsh-plugin; development happens in the aflare monorepo.
Alternatives
omdsh-dev/dsh_workflow · icetomoyo/dsh_workflow