Sync

Sync keeps your Kitten data the same on every machine. It saves your data to a private git repository that you own. There is no Kitten account and no Kitten server in between.

What Syncs

Choose what to sync under Settings → Sync → What to Sync:

  • Settings: theme, keymap and the rest of your preferences.
  • Collections
  • Environments: environments and globals, encrypted with a password. This is off until you set up encryption.
  • Requests: your favorites.
  • History

Set It Up

  1. Open Settings → Sync and choose Connect….
  2. Enter the URL of a repository you own on any git host. If you have the GitHub CLI (gh), Kitten can create the repository for you.
  3. Choose Sync Now, or turn on Sync on a Schedule to sync every few minutes when something changed. Ask to Sync When Closing reminds you before you quit.

Kitten uses the git installed on your machine and its credentials, such as SSH keys or a credential helper.

On Another Machine

Connect the same repository. When it already holds data, Kitten asks whether to Merge, Use Remote or Use Local. Choose Use Remote to restore everything from your other machine.

Encrypted Environments

Environments often hold tokens and passwords, so Kitten encrypts them on your machine before they leave it. Variable names are encrypted along with their values. Set a password under Environment Encryption, then keep the recovery key Kitten shows you. Either one unlocks your environments on another machine.

Sync and Collection Git

Sync backs up your Kitten data to a repository Kitten manages for you. Collection Git is for working with the repository a collection already lives in, with commits, branches and pull requests on your team's terms. You can use both.