Files
united-workforce/packages/workflow-agent-hermes
xingyue a5c09adae6 docs: add README.md to all 8 packages
Each README includes: package description, install instructions,
usage example, API overview, and (for templates) role/moderator flow.

Packages documented:
- @uncaged/workflow (core)
- @uncaged/cli-workflow (CLI)
- @uncaged/workflow-agent-cursor
- @uncaged/workflow-agent-hermes
- @uncaged/workflow-agent-llm
- @uncaged/workflow-template-develop
- @uncaged/workflow-template-solve-issue
- @uncaged/workflow-util-agent
2026-05-08 10:17:40 +08:00
..

@uncaged/workflow-agent-hermes

AgentFn adapter that runs the hermes CLI in non-interactive chat mode (Nerve-style flags: -q, --yolo, --quiet, bounded --max-turns).

The agent composes the same thread-aware prompt as other CLI-backed agents via buildAgentPrompt from @uncaged/workflow-util-agent, then spawns hermes and returns stdout on success.

Install

bun add @uncaged/workflow-agent-hermes @uncaged/workflow @uncaged/workflow-util-agent

In this monorepo: use workspace:* for all three @uncaged/* packages.

Usage

import { createHermesAgent } from "@uncaged/workflow-agent-hermes";

const agent = createHermesAgent({
  model: "your-model", // or null to omit --model
  timeout: 600_000, // ms, or null for no timeout
});

API overview

Export Description
createHermesAgent(config) Returns AgentFn wrapping hermes chat -q ...
HermesAgentConfig model, timeout
validateHermesAgentConfig Config validation result
buildAgentPrompt Re-exported from @uncaged/workflow-util-agent

Requires hermes on PATH at runtime.