Tortilloid
How it works / Tortilloid and Git

Docs / How it works / Tortilloid and Git

Tortilloid and Git

Git knows what happened. Tortilloid knows why.

Tortilloid isn't a Git client, and it doesn't replace Git. It works alongside it. Git records the snapshots you choose to commit. Tortilloid records everything in between: every change from every person and agent, with who made it and why, and the plans and decisions around it. It is the missing link between your commits.

What each one sees

GitTortilloid
What it recordsThe snapshots you commitEvery change as it happens, by people and agents
DetailOne message per commitWho or which agent, when, what it touched, the file before and after
The whyWhatever the commit message saysThe thread, the decisions, the plan and the attempts that failed
UndoRevert or reset whole commitsRoll back one change in one file, or return to a checkpoint
AgentsSee the resultSee the whole history, and record their work as they go

Between the commits

Most of the real work happens between commits. The experiments, the dead ends, the fix that was tried and dropped, the agent that changed twelve files before anyone noticed. Git never sees any of it. Tortilloid keeps all of it, searchable, so you can find the change that matters even when it was never committed on its own.

How they work together

  • Tortilloid never touches your Git data. Rolling back or restoring in Tortilloid changes your files, never your Git history.
  • Tortilloid follows Git. When a project is a Git repository, commits and branch switches appear in the Patch Log as Git checkpoints, right alongside the changes in between.
  • Kept out of your commits. Tortilloid's own folder keeps itself out of Git, apart from Project Memory, which is meant to be shared. See Git and syncing.
  • Commits stay yours. Kongo always asks before publishing a commit or running a risky Git command, such as a hard reset or a force push. See Tools and permissions.

Keep using Git the way you do

Branch, commit, review and merge exactly as you do now, from the terminal or any Git tool. Tortilloid fills in the detail Git was never designed to hold.

Git knows what happened. Tortilloid knows why.