smithers-supervise

Watch explicitly named stale runs and auto-resume them; pass --all to opt into a workspace-wide sweep. Run `smithers supervise --help` for usage details.

Jump to install

Repository: smithersai/smithers
Last source activity: July 14, 2026 at 08:01
Detected SKILL.md language: English
Stars: 404
Forks: 50

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/smithersai/smithers --skill smithers-supervise

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

smithers

Drive Smithers, a durable control plane for long-running coding agents, from Claude Code. Use when the user wants multi-step, long-running, crash-safe, or human-in-the-loop agent work ('orchestrate agents', 'run a workflow', 'implement this and review it', 'keep iterating until tests pass', 'plan then build') or anything needing retries, approvals, replay, or evals across multiple AI steps. YOU (Claude) run Smithers on the user's behalf; it is not a GUI the human clicks. HARD RULE 0, if `SMITHERS_INSIDE_RUN` is set in your environment you are ALREADY a worker agent inside a Smithers node, so never invoke the Smithers CLI or MCP tools to launch or steer a run, just do the node's task directly with your ordinary tools; every rule below applies only when it is unset. HARD RULE 1, right-size the route FIRST, handle ANY clear single-goal ask directly, even a large repo-wide one, and reserve a full workflow for work that genuinely needs ordered stages, durability, approvals, loops, or reuse; never author a multi-no

2026-08-27

smithers

Drive Smithers, a durable control plane for long-running coding agents, from Codex. Use when the user wants multi-step, long-running, crash-safe, or human-in-the-loop agent work ("orchestrate agents", "run a workflow", "implement this and review it", "keep iterating until tests pass", "plan then build") or anything needing retries, approvals, replay, or evals across multiple AI steps. YOU (Codex) run Smithers on the user's behalf; it is not a GUI the human clicks. HARD RULE 0: if `SMITHERS_INSIDE_RUN` is set in your environment you are ALREADY a worker agent inside a Smithers node — never invoke the Smithers CLI or MCP tools to launch or steer a run, just do the node's task directly with your ordinary tools; every rule below applies only when it is unset. HARD RULE 1: right-size the route FIRST, handle a clear well-scoped single-goal task directly, and reserve a full workflow for work that genuinely needs ordered stages, durability, approvals, loops, or reuse. A workflow that runs long, fans out, or pauses on

2026-08-27

smithers

Drive Smithers, a durable control plane for long-running coding agents. Use when the user wants multi-step, long-running, crash-safe, or human-in-the-loop agent work: "orchestrate agents", "run a workflow", "implement this and review it", "keep iterating until tests pass", "plan then build", or anything that needs retries, approvals, replay, or evals across multiple AI steps. YOU (the agent) run Smithers on the user's behalf; it is not a GUI the human clicks. HARD RULE 0: if `SMITHERS_INSIDE_RUN` is set in your environment you are ALREADY a worker agent inside a Smithers node, so never invoke the Smithers CLI or MCP tools to launch or steer a run; do the node's task directly with your ordinary tools. Everything below applies only when it is unset. You are otherwise an ORCHESTRATOR: run long-running, multi-step, or background work *through* Smithers, not through your own ad-hoc subagents; spend your time observing the run and reporting. Also governs DELIVERABLE SHAPE even when no workflow is involved: a user

2026-08-27

View all from this repository

Flag	Type	Default	Description
`--run`	`string`		Only supervise these run IDs (comma-separated)
`--all`	`boolean`	`false`	Explicitly supervise every eligible run in the workspace
`--dryRun`	`boolean`	`false`	Show which stale runs would be resumed, without acting
`--interval`	`string`	`10s`	Poll interval (e.g. 10s, 30s, 1m)
`--staleThreshold`	`string`	`30s`	Heartbeat staleness threshold before resume
`--maxConcurrent`	`number`	`3`	Max runs resumed per poll

Flag	Type	Default	Description
`--run`	`string`		Only supervise these run IDs (comma-separated)
`--all`	`boolean`	`false`	Explicitly supervise every eligible run in the workspace
`--dryRun`	`boolean`	`false`	Show which stale runs would be resumed, without acting
`--interval`	`string`	`10s`	Poll interval (e.g. 10s, 30s, 1m)
`--staleThreshold`	`string`	`30s`	Heartbeat staleness threshold before resume
`--maxConcurrent`	`number`	`3`	Max runs resumed per poll

smithers-supervise

Install options

Review the source files