Skip to main content

scripts/worktree-feature/run.sh

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

Source

package.json

config.ts

preload.ts

Key Details

  • USE_CLI_AGENTS=1 selects CLI agents (Claude Code / Codex CLI) over API agents. SMITHERS_UNSAFE=1 enables dangerouslySkipPermissions, bypassing Claude Code’s permission prompts for headless, unattended runs. Only use it in a sandboxed environment: the agent gets 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.