Skip to main content

Timeline: steps, going back and forking

Timeline (Mod+3) is the task's history. It answers "what happened in this task, and in what order".

What it lists​

EntryWhat it is
CommitsNewest first, each with what it applied. The newest has Undo. Every commit and undo is also an entry in the task's signed history (kule history TASK).
StepsThe uncommitted tool calls, each with the files it changed. A commit starts the steps over.
ConnectionsThe network connections the task's commands made, and whether each was let through, asked about or refused.
RefusalsWhat the sandbox refused the commands. macOS reports them; on Linux the command sees the error but Kule cannot list it.

Undo a commit​

Undo (Mod+Shift+U, press twice) reverts the task's newest commit in your folder and in the copy, putting back what the commit replaced from the task's checkpoint. Repeat it to walk further back. See Review, commit and undo.

Go back to a step​

Every step, and "before the first step", has two actions. The first is Go back here: it puts the copy back as it was after that step.

  • Going back is itself a step, so you can go back on it.
  • Changes made since the last step are kept as a step first, so nothing is lost.
  • A step that cannot be gone back to says why: a file over 64 MB, more than 1 GB in one go, or a file with a second name (a hard link).
  • .git is not put back. A commit starts the steps over.

Fork a task​

The second action is Fork from here: it makes a new task on the same folder that starts from this one's copy as it was after that step. Fork task in the task's ⋮ menu (Mod+Shift+D) forks from the copy as it is now.

The fork takes the task's name with "(fork)", its colour, group, budget and secret stand-ins, and has no steps or commits of its own. Its changes reach the folder through its own review and commit.

When to fork

Fork when you want to try another direction without losing this one, or to run two agents on two ideas and keep the better result.

From a terminal​

kule steps lists the steps of the uncommitted work, kule undo reverts the newest commit, and kule history prints the signed history, checked entry by entry. Going back to a step and forking are in the app only.