IshooThe Ishoo manual

Your data / Page 37 of 53

This page is one part of The Ishoo manual. The complete manual is a single page, short enough to read in one go: ishoo.app/docs/

Where records live

Ishoo keeps one small file per task, decision and person under .ishoo/records in your project. That folder is ignored by your main branch; its history is saved on a separate Git ref, refs/ishoo/store, so your code history never fills up with record changes.

In plain terms: your records live in your project, but out of your code’s way. git log on your code shows only code changes, while every change to a task or decision is still saved with full history.

One file per record

Each task, decision and person is its own file, and a save writes only the records that changed. Two people editing different tasks never collide. If the same record changed in two places at once, Ishoo stops and shows the conflict instead of silently keeping one side.

One careful writer

A small background service on your computer is the single writer for a project’s records, so the app and several agents can all make changes at the same time without corrupting anything. Worktrees never get their own copy: there is one store per project, in the main folder.