Working with agents

See what changed while you were away, review it, and keep your own edits safe.

An agent edits files in your folder while you look at something else. Rip shows you what it touched and keeps your unsaved work out of its way. It also gives you a place to review the result.

Changed while you were away#

A file that changed on disk while you looked elsewhere gets a dot. The dot shows in the file tree and on the tab. A deleted file gets no dot. In an open file, the lines that changed get a tint in the gutter. The tint stays until those lines have been on screen while the window had focus.

A file with no unsaved edits reloads from disk on its own. A deleted file keeps its last contents.

Your edits stay yours#

A file can change on disk while you have unsaved edits in it. Rip then merges three ways: your edits, the change on disk, and the text both started from. Edits that touch different lines merge without a question.

Edits that overlap become conflict regions in the buffer, with both versions marked. MCtrl+Alt+M jumps to the next conflict and MCtrl+Alt+Shift+M to the previous one. YCtrl+Alt+Y keeps your version of the region, and TCtrl+Alt+T takes the version from disk. A save never writes over what the agent wrote: Rip merges first. A deleted file is the exception: a save creates it again.

Review what the agent did#

Before the agent starts, save your files and press GCtrl+Alt+Shift+G to mark a baseline. Wait for the message that the baseline is ready. When it is done, press GCtrl+Alt+G. The review shows every change since the baseline, new files included, even when the agent committed along the way. New files that .gitignore names stay out.

In the review, AA marks a hunk reviewed and folds it away. Reviewed marks survive reopening Rip and do not stage changes. XX reverts a hunk in the working tree. ZCtrl+Z undoes a revert. CC leaves a note. When you are done, EE copies every note as Markdown, ready to paste back to the agent. Git and review lists the other keys.

Hot exit#

Quitting never asks about unsaved files. Rip saves a snapshot of each unsaved buffer in the background and again when you quit. The next time a window opens on that folder, the buffers come back. Rip merges them with any change the agent made on disk in between. Set hot-exit = false and a window with unsaved edits refuses to close until you save or close them. Quitting never asks.

Keys#

Settings#