Ripul

Help · Beyond the chat

Repos: the chats behind the code

Everyone working in a repository can see the chat behind each commit, and pick up the conversation that built the code.

5 minute read

A commit tells you what changed. The chat that made it tells you why: what was asked for, what was tried, what was ruled out. Ripul saves that chat in the repository alongside the code, so it is shared the way the code is.

That turns a repository into your team’s memory. When a teammate’s agent built something, you can read the conversation behind it, then carry it on yourself with all of its context, instead of starting a fresh chat and explaining everything again. The same works for you alone: a chat can move to another of your Macs when the one it ran on is switched off.

The History view of the ripul repository: commits in order beside their branch lines, most of them followed by a small bubble in the colour of the chat that made them.
Every commit, and the chat that made itHistory keeps git’s own order. The coloured bubble after a commit’s short ID marks the chat that made it, whoever ran it.

What it gives a team

See why it changed
A commit leads to the chat behind it, so the reasoning comes with the change, not only the diff.
Pick up where they left off
Continue a teammate’s chat on your own Mac. The agent starts with everything that conversation already knew.
Read it as it was
Open a chat exactly as it stood when a commit was made, to see what the agent understood at that point.
Hand work over with its history
When someone passes a piece of work on, its chats stay with the code, so the next person starts with the whole story.

Find your repositories

Open Repos from the sidebar. It lists the repositories on the Mac named at the top of the screen; tap the name to switch Mac. Each row shows its branch, how many files are uncommitted, and how many chats have committed there.

The Repos list on peter’s Mac Studio: ripul on main with 2 uncommitted files and 207 chats, and WAC_ios_final on a feature branch with 2 chats.
Your Mac’s repositoriesThe chat count shows how many conversations have committed in each repository.
  • Swipe right on a repository to pin it to the top.
  • Search by name, or type owner/repo to clone one from GitHub.
  • Long-press a row to copy its branch name.

History: the commits in order

Open a repository and History shows its commits in git’s order, with the branch lines drawn beside them. A commit made by a chat carries a bubble in that chat’s colour, so one conversation’s commits stand out even when other people’s landed in between.

  • Tap a commit to read its message, the files it touched, and the diff.
  • Long-press a commit and choose Show chat to go to the chat that made it.
  • Long runs of commits fold into “N commits”. Tap to open them.
  • Branches lists every local and remote branch. Tap a branch above the history to hide or show its line.
A commit’s detail: its message, the Appium runner chat with an Open as of This Commit button, the author and date, three changed files, and the diff in green.
A commit, and the chat behind itThe chat that made the commit sits under its message. Tap Diff to read the change itself.

Open as of This Commit shows the chat read-only, exactly as it stood when the commit was made. Tap Resume to carry on from that point.

Chats: the conversations that built it

Switch to Chats to see the same repository by conversation. Every chat that committed here is listed in its colour, whichever Mac it ran on, with how many commits and files it changed and where it deployed. Tap one to see all of its commits together.

The Chats view of the ripul repository: chats such as Appium runner, Comms refactor and New user flow, each with its commit and file counts and where it deployed.
The same repository, by conversationEach chat keeps its colour from History, so you can follow it from one view to the other.

Pick up a chat, yours or a teammate’s

When a Claude chat in Ripul commits, Ripul saves the chat with the commit, on a branch of the repository called claude-sessions. Any Mac with a copy of the repository can read it, so a chat can be carried on by anyone on the team, or by you on another Mac.

  1. Choose the Mac to continue onTap the Mac’s name at the top of Repos and pick your own. It needs Ripul Host and its own clone of the repository.
  2. Open the repository, then ChatsFind the chat in the list, whoever started it, and tap it.
  3. Tap Continue on <your Mac>Your Mac fetches the newest saved copy and opens it as a new chat of your own, and Ripul takes you there.
The Appium runner chat’s screen, with Continue on peter’s Mac Studio at the top, then its 42 commits and 62 files.
Pick up the chat behind the codeA chat’s own screen: Continue at the top, then every commit it made.

What is saved, and what is not

  • Claude chats run by Ripul Host are saved, for everyone on the team who works that way. Codex and Antigravity chats, and sessions started in a plain terminal, are not.
  • A chat is saved when it commits. What it says after its last commit is saved with its next one.
  • Saving needs an origin remote you can push to. Reading needs a clone of the repository.
  • Chats lists recent chats, not every chat the repository has ever had.
  • History’s bubbles come from the Mac’s last fetch. Pull down to refresh.