Skip to main content

Documentation Index

Fetch the complete documentation index at: https://smithers.sh/llms.txt

Use this file to discover all available pages before exploring further.

Each successful task attempt captures the current JJ change ID into _smithers_attempts.jj_pointer. revert restores the workspace to that state and trims any DB frames recorded after the attempt started. 
bunx smithers-orchestrator revert workflow.tsx \
  --run-id <id> --node-id <node> [--attempt N=1] [--iteration N=0]
Revert restores files only — it doesn’t alter JJ history; the restoration creates a new change on top of the current working copy.

​
Requirements

  • JJ in PATH (brew install jj or cargo install jj-cli)
  • Workspace is a JJ repository (jj git init or jj init)
  • The target attempt was completed when JJ was available (otherwise no pointer was captured)

​
Programmatic

import { revertToAttempt } from "smithers-orchestrator";

await revertToAttempt({
  runId: "abc123",
  nodeId: "implement",
  attempt: 2,
  iteration: 0,
});
revertToAttempt throws if the attempt has no recorded JJ pointer.