From 3074cd5f0c70a85f0848c680f75d1ece4245e7d4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=B0=8F=E6=A9=98?= <xiaoju@shazhou.work>
Date: Tue, 12 May 2026 02:49:58 +0000
Subject: [PATCH 1/3] chore: add .env.example with all supported env vars

Documents all environment variables used across the workflow engine:
- LLM config (base URL, API key, model)
- Cursor agent config (model, timeout, provider)
- Hermes agent config (model, timeout)
- Storage and display options

Fixes #205
---
 .env.example | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 .env.example

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..d3d297e
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,50 @@
+# ──────────────────────────────────────────────
+# Workflow Engine — Environment Variables
+# ──────────────────────────────────────────────
+# Copy this file to .env and fill in the values.
+
+# ── LLM (used by workflow-template-develop for AI-assisted coding) ──
+
+# OpenAI-compatible base URL for LLM calls
+# Default: https://dashscope.aliyuncs.com/compatible-mode/v1
+WORKFLOW_LLM_BASE_URL=
+
+# API key for LLM calls (required when using LLM features)
+WORKFLOW_LLM_API_KEY=
+
+# Model name for LLM calls
+# Default: qwen-plus
+WORKFLOW_LLM_MODEL=
+
+# ── Cursor Agent ──
+
+# Model override for Cursor agent
+WORKFLOW_CURSOR_MODEL=
+
+# Timeout in milliseconds for Cursor agent operations
+WORKFLOW_CURSOR_TIMEOUT=
+
+# LLM provider for Cursor agent (e.g. anthropic, openai)
+WORKFLOW_CURSOR_LLM_PROVIDER=
+
+# ── Hermes Agent (used by workflow-template-solve-issue) ──
+
+# Model override for Hermes agent
+WORKFLOW_HERMES_MODEL=
+
+# Timeout in milliseconds for Hermes agent operations
+WORKFLOW_HERMES_TIMEOUT=
+
+# ── Storage ──
+
+# Override the workflow storage root directory
+# Default: ~/.uncaged/workflow
+WORKFLOW_STORAGE_ROOT=
+
+# Gateway secret for the serve command
+WORKFLOW_GATEWAY_SECRET=
+
+# ── Display ──
+
+# Set to any value to disable colored output
+# NO_COLOR=1

From 64dadf114d33c52b723bb04ea11896a053574c1f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=B0=8F=E6=A9=98?= <xiaoju@shazhou.work>
Date: Fri, 15 May 2026 01:02:56 +0000
Subject: [PATCH 2/3] fix: align .env.example with actual env vars
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Remove non-existent: WORKFLOW_LLM_BASE_URL, WORKFLOW_LLM_MODEL, WORKFLOW_CURSOR_LLM_PROVIDER
- Add missing: WORKFLOW_CURSOR_COMMAND (required for develop workflow)

小橘 🍊
---
 .env.example | 14 +++-----------
 1 file changed, 3 insertions(+), 11 deletions(-)

diff --git a/.env.example b/.env.example
index d3d297e..72dfc41 100644
--- a/.env.example
+++ b/.env.example
@@ -5,28 +5,20 @@
 
 # ── LLM (used by workflow-template-develop for AI-assisted coding) ──
 
-# OpenAI-compatible base URL for LLM calls
-# Default: https://dashscope.aliyuncs.com/compatible-mode/v1
-WORKFLOW_LLM_BASE_URL=
-
 # API key for LLM calls (required when using LLM features)
 WORKFLOW_LLM_API_KEY=
 
-# Model name for LLM calls
-# Default: qwen-plus
-WORKFLOW_LLM_MODEL=
-
 # ── Cursor Agent ──
 
+# CLI command to invoke the Cursor agent (required for develop workflow)
+WORKFLOW_CURSOR_COMMAND=
+
 # Model override for Cursor agent
 WORKFLOW_CURSOR_MODEL=
 
 # Timeout in milliseconds for Cursor agent operations
 WORKFLOW_CURSOR_TIMEOUT=
 
-# LLM provider for Cursor agent (e.g. anthropic, openai)
-WORKFLOW_CURSOR_LLM_PROVIDER=
-
 # ── Hermes Agent (used by workflow-template-solve-issue) ──
 
 # Model override for Hermes agent

From 0871ae54ea1a990e7c08c211868030f83349bfda Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=B0=8F=E6=A9=98?= <xiaoju@shazhou.work>
Date: Fri, 15 May 2026 01:24:29 +0000
Subject: [PATCH 3/3] fix: remove unused WORKFLOW_LLM_API_KEY per review
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

No consumers after #262 removed llmProvider from bundle entries.
WORKFLOW_CURSOR_WORKSPACE has no env var counterpart, not added.

小橘 🍊
---
 .env.example | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/.env.example b/.env.example
index 72dfc41..c6c65be 100644
--- a/.env.example
+++ b/.env.example
@@ -3,11 +3,6 @@
 # ──────────────────────────────────────────────
 # Copy this file to .env and fill in the values.
 
-# ── LLM (used by workflow-template-develop for AI-assisted coding) ──
-
-# API key for LLM calls (required when using LLM features)
-WORKFLOW_LLM_API_KEY=
-
 # ── Cursor Agent ──
 
 # CLI command to invoke the Cursor agent (required for develop workflow)