Rescriptum
Browse docs

Docs / Workspace

Git and worktrees

Commit, branch, review diffs, and manage isolated agent worktrees.

The Git panel is a working Git client built on your repository, with extra tools for agent work. Open it with Ctrl+4.

Changes

Stage and unstage files, discard changes, write a commit message, and commit. Push and pull are here too, with ahead and behind counts against the upstream. Select a file to see its diff.

The agent can use Git as well, through git_status, git_diff, git_log, git_commit, git_checkout, git_clone, git_push, git_pull, and git_stash. Commit and push ask for approval in the default preset. See Approvals and safety.

History

Browse commits and open their diffs.

Branches

Check out, create, delete, and merge branches, and see your remotes.

Worktrees

A worktree is a second working copy of the same repository on its own branch. Agent work that you want kept apart from your own can run there, so it cannot disturb files you are editing.

  • The Worktrees tab lists them, and marks the ones created by an agent.
  • Merge brings a worktree's branch back into the one you are on.
  • Discard removes the worktree and its branch.

Choose when worktrees are used in Settings, 02 · Agent & Verification:

ModeBehavior
autoRescriptum decides based on the job
neverAlways work in your checkout
alwaysAlways isolate agent work

The Strict Isolated Sandbox profile turns worktrees on together with the Strict permission preset.

Rescriptum's own files

The agent writes working state to a .rescriptum folder in your project: checkpoints, the scratchpad, and the dev-server record. Rescriptum adds .rescriptum/ to the repository's local git exclude, so it does not show up in your changes or get committed by accident. It does not touch your .gitignore.

Claim checking

When the agent says it committed, or that your tree is clean, Rescriptum compares the statement with git itself. See Verification and rollback.