Skip to main content
vcs is an archived example and is not installed by init. Copy it from examples/init-pack/ with its dependency closure, or ask create-workflow to build an equivalent. Once installed, run it with the command below. vcs is a small dispatcher workflow over a git or jj working tree. Status and log are deterministic (no agent); commit messages and rebase plans are written by an agent from the real diff and history. The Smithers UI launches it with an action, but it runs from the CLI too.
vcs workflow UI showing a git working tree and action controls

The vcs UI shows the working tree for the run and dispatches git or jj actions like status, log, commit, and rebase.

Actions

  • status (default): deterministic working-tree summary, including tool, branch, head, clean flag, and the list of changes.
  • log: deterministic recent-history summary (commit ids + subjects).
  • commit: read the diff, then an agent writes a commit message plus the command to apply it.
  • rebase-plan: read status and log, then an agent proposes an ordered rebase plan.

Inputs

Smithers prefers .jj over .git in colocated repos; pure Git repos work without JJ installed. See Recipes for how vcs relates to per-attempt snapshots and revert.