How do I use an Ishoo project on a second computer?

Getting started / Page 10 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/

A second computer

To use an Ishoo project on a second computer, install Ishoo there, clone the project, and run ishoo enable in the clone. Enable brings in the project’s records from the remote and sets up this computer’s agent connection. ishoo status then shows the same tasks and plans.

Install Ishoo
Use the installer on the second computer, the same as the first.
Clone the project
git clone <your remote>, as you normally would. A plain clone does not bring Ishoo’s records yet; that is fine.
Run ishoo enable in the clone
It fetches the records from the remote (they travel on refs/ishoo/store), writes this computer’s agent settings and hooks, and keeps the project’s saved choice about CLAUDE.md.
Check it
Run ishoo status in the clone: it shows the same active plan and tasks as the first computer. Then add the folder in the app with Add project, and start your agent in that folder.

Shared through the remote	Set up on each computer
Tasks, decisions, plans, people, comments, the north star	Agent settings and hooks, the background service, where a moved records folder lives, and how checks run

If enable says it cannot reach the remote

Ishoo will not start a fresh, empty set of records over a remote it could not read, because that would hide the real ones. Fix the Git sign-in or network problem, then run ishoo enable again.