> ## Documentation Index
> Fetch the complete documentation index at: https://smithers-feat-claude-workflow-mirror.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Ghost: scripts/worktree-feature/run.sh

> Example from scripts/worktree-feature/run.sh: shell script launcher for the worktree-feature workflow with environment setup for CLI agents, debug mode, and unsafe permissions.

# scripts/worktree-feature/run.sh

<Note>
  **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.
</Note>

## Source

```bash theme={null}
#!/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

```json theme={null}
{
  "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

```ts theme={null}
// 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

```ts theme={null}
// 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.