@alib8b8/dsh-plugin-aflare
DeepSeek Harness (DSH)
Cordis plugin that exposes aflare
workflow tools as native DSH tools.
Every tool spawns the local aflare binary with execFile (no shell), so
nothing leaves your machine — the same local-first guarantee aflare itself
makes.
Tools
| Tool | What it does |
|---|---|
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 |
aflare_template_run |
Run a template by ID |
Install
Prerequisite: the aflare binary
The plugin drives the local aflare CLI, so install it first (one line; see
the aflare README for Windows/source
options):
curl -fsSL https://raw.githubusercontent.com/alib8b8/aflare/main/install.sh | bash
aflare version # sanity checkOne-line install into DSH
dsh plugin --profile web add @alib8b8/dsh-plugin-aflarePublished on npm (@alib8b8/dsh-plugin-aflare);
the github:alib8b8/dsh-plugin-aflare spec works too.
The package declares its bundle patch (dsh.bundle.patch in package.json),
so DSH registers the plugin entry automatically — restart dsh web and the
aflare_* tools are live. No profile editing needed.
From a local checkout
git clone https://github.com/alib8b8/dsh-plugin-aflare
cd dsh-plugin-aflare
npm install && npm run build
dsh plugin --profile web add "$PWD"This repository is the distribution mirror of
aflare/integrations/dsh-plugin;
development happens in the aflare monorepo.
Or register the built entry manually with a cordis.yml patch overlay
(absolute path required):
- insert:
- id: aflare-tools
name: /absolute/path/to/aflare/integrations/dsh-plugin/dist/index.jsStart DSH with the overlay:
pnpm dsh web --patch ./aflare-patch.ymlConfiguration
| Env var | Default | Description |
|---|---|---|
AFLARE_BIN |
aflare |
Path to the aflare executable |
AFLARE_TIMEOUT_MS |
300000 |
Per-invocation timeout (ms) |
Security
- All invocations use
execFile— arguments are passed as argv, never
through a shell, so tool parameters cannot inject commands. - Output is truncated at 256 KB to protect model context.
- aflare's own protections (path validation, safe mode, policy engine) apply
to every run. SetAFLARE_SAFE_MODE=1in the DSH process environment for
untrusted workflows.
Development
npm install
npm run typecheck # strict TS check
npm test # compiles, then runs integration tests via node --testThe tests execute the real aflare binary, resolved from AFLARE_BIN or
the repo-root build output (make build in the repository root). Without a
binary, the registration checks still run and the binary tests skip.
License
AGPL-3.0-or-later (same as the aflare project).