Skip to main content

​
scripts/worktree-feature/run.sh

Example: aspirational launcher script for a scripts/worktree-feature/run.sh workflow directory. The scripts/worktree-feature/ directory does not exist on main; this doc shows the intended structure for a worktree-feature workflow.

​
Source

#!/usr/bin/env bash
# Run the Worktree+MergeQueue feature workflow
# Usage: ./run.sh

set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
ROOT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"

cd "$SCRIPT_DIR"

export USE_CLI_AGENTS=1
export SMITHERS_DEBUG=1
export SMITHERS_UNSAFE=1
unset ANTHROPIC_API_KEY

SMITHERS_CLI="${SMITHERS_CLI:-./node_modules/.bin/smithers}"

echo "Starting Worktree+MergeQueue feature workflow"
echo "Root directory: $ROOT_DIR"
echo "Press Ctrl+C to stop."
echo ""

bun "$SMITHERS_CLI" up workflow.tsx --input '{}' --root "$ROOT_DIR"

​
package.json

{
  "name": "worktree-feature-workflow",
  "type": "module",
  "scripts": {
    "start": "bun run workflow.tsx",
    "resume": "bunx smithers-orchestrator up workflow.tsx --run-id RUN_ID --resume true",
    "typecheck": "tsc --noEmit"
  },
  "dependencies": {
    "@ai-sdk/anthropic": "^3.0.71",
    "@ai-sdk/openai": "^3.0.53",
    "ai": "^6.0.168",
    "smithers-orchestrator": "file:../../",
    "zod": "^4.3.6"
  }
}

​
config.ts

// scripts/worktree-feature/config.ts

/** Maximum review->fix rounds before the validation loop gives up. */
export const MAX_REVIEW_ROUNDS = 3;

/** Steps per review round (implement + validate + review + reviewfix). */
export const STEPS_PER_ROUND = 4;

​
preload.ts

// scripts/worktree-feature/preload.ts
import { mdxPlugin } from "smithers-orchestrator/mdx-plugin";

mdxPlugin();

​
Key Details

  • USE_CLI_AGENTS=1 selects CLI agents (Claude Code / Codex CLI) over API agents. SMITHERS_UNSAFE=1 enables dangerouslySkipPermissions for unattended execution. This bypasses Claude Code’s permission prompts so the workflow can run headlessly. Only use it in a sandboxed environment; the agent will have unrestricted filesystem and shell access.
  • "smithers-orchestrator": "file:../../" links to the local package for co-development.
  • preload.ts registers the MDX plugin, enabling .mdx imports as JSX components.
  • --root passes the repository root so agents access the full codebase, not just the workflow directory.
  • bunx smithers-orchestrator up workflow.tsx --run-id RUN_ID --resume true resumes from the last checkpoint.