Settings sync

Settings sync keeps Claudette’s settings the same on every machine that uses the same session library folder. Change your theme on one machine and the others follow.

Turning it on

  1. Open Settings → Sessions.
  2. Turn on Sync Claudette’s settings through the library. It’s off by default.

If the library already holds settings from another machine, Claudette asks: The library already has settings from another machine. Which should this machine use?

  • Use synced settings takes the library’s settings, and every page shows them.
  • Replace them with this machine’s publishes this machine’s settings to the library instead.
  • Cancel leaves sync off.

Turning it off keeps the settings as they are on this machine and stops syncing.

What syncs

  • Appearance, except Zoom, which suits each machine’s screen.
  • Conversation, except Show every hook run, Messages sent while Claude works and Suggest my next prompt.
  • Notifications.
  • Keyboard: the shortcuts, Send with and the quick suffixes.
  • Tabs, except Subagents and your favorite folders: what new tabs start with, what they do at a usage limit, check-ins and the process monitor.
  • Usage, except Detailed usage header: the warning levels, usage history and Share usage with my other machines.

What stays on each machine

  • Whether Claudette starts at login, and the rest of Settings → General.
  • The path to claude, the login shell setting, and the Claude app settings (Settings → Claude Code).
  • This page’s own settings: the machine’s name, the library folder, how long library sessions are kept, and whether new tabs sync.
  • Settings → Files and diffs, Settings → Project tools, and Source control’s pages but Git’s Show the git branch: Git’s worktrees, path to git and Files tab choices, and Perforce. Program paths and installed tools differ between machines, and a Perforce server, workspace and stored password belong to the machine.
  • Accounts and their keys.
  • Recent and favorite folders, folder mappings, pinned tabs, and window sizes and positions.

A stored Perforce password is never in a settings file at all. See Passwords and keys.

Every setting says, for each setting, whether it syncs.

How it merges

Claudette compares settings at launch, after each change you make, and once a minute to pick up changes from other machines. Each setting keeps the time it was last changed, and the newest change wins, so edits on two machines don’t overwrite each other wholesale. A change on one machine and a different one on another both survive. When both changed the same setting, the newer one wins. Lists, such as quick suffixes, sync as one value.

The synced settings are one file in the library, settings-sync.json.

Settings

Setting Default Where
Sync Claudette’s settings through the library Off Settings → Sessions

No Reset to defaults changes it.

See also

Back to top

Claudette is made by dotBunny under the MIT license. Privacy policy

Claude and Claude Code are trademarks of Anthropic, PBC. Godot and the Godot logo are trademarks of the Godot Foundation; the logo is by Andrea Calabró, under CC BY 4.0. Unity is a trademark or registered trademark of Unity Technologies or its affiliates in the U.S. and elsewhere. Unreal®, Unreal Engine®, and the Unreal Engine® logo are trademarks or registered trademarks of Epic Games, Inc. in the United States of America and elsewhere. Other brands or product names are the trademarks of their respective owners. The logo is used with Epic's permission. Perforce, P4V and the Perforce logo are trademarks of Perforce Software, Inc. or one of its affiliates; the logo is used with Perforce's permission. Claudette isn't sponsored by, affiliated with or endorsed by any of them. Other names are trademarks of their owners.

Edit this page on GitHub

This site uses Just the Docs, a documentation theme for Jekyll.