# jj-musubi

> Your jj repositories on every machine you use, always up to date. Close the laptop, pick up on the desktop, and let agents on every machine see each other's work.

These are content-only Markdown versions of the jj-musubi user guide. Use the single page that
matches the task. For exact syntax and behavior of an installed version, use the local
command's `--help`.

## Start here

- [Get started](https://www.serpentine.com/software/jj-musubi/get-started.md)
  Install jj-musubi, start a hub, and share a repository between your machines.

- [How musubi works](https://www.serpentine.com/software/jj-musubi/how-it-works.md)
  What moves between machines, what stays on each, and what happens when machines change the same thing.

- [How musubi keeps your work safe](https://www.serpentine.com/software/jj-musubi/safety.md)
  What jj-musubi promises, and the proofs, tests and design choices that keep every machine's work intact.

## Guides

- [Set up a hub and machines](https://www.serpentine.com/software/jj-musubi/guides/set-up.md)
  Choose the hub's machine, share a repository, and add the other machines over ssh.

- [Work across machines](https://www.serpentine.com/software/jj-musubi/guides/working-across-machines.md)
  See other machines' work, update a stale working copy, undo, and share settings.

- [Manage hives, machines, and hubs](https://www.serpentine.com/software/jj-musubi/guides/manage.md)
  Check on syncing, rename or remove hives, take machines out, upgrade, and replace a hub.

## Look things up

- [Command reference](https://www.serpentine.com/software/jj-musubi/reference/commands.md)
  Every musubi command, grouped by task.

- [Configuration](https://www.serpentine.com/software/jj-musubi/reference/configuration.md)
  Settings, environment variables, logging, and where musubi keeps its files.

- [How musubi compares with other approaches](https://www.serpentine.com/software/jj-musubi/comparison.md)
  File syncing, a git remote, and working on one remote machine, compared with jj-musubi.

- [Changelog](https://www.serpentine.com/software/jj-musubi/changelog.md)
  What changes in each release, and what to do on upgrading.

## Fix a problem

- [Troubleshooting](https://www.serpentine.com/software/jj-musubi/troubleshooting.md)
  Messages musubi prints, and what to do about each.