Skip to main content
Device Sync shares selected agent configuration between computers signed into your Kisuke account. Use it to bring provider connections, preferences, and supported user-level tools to another computer. On a fresh installation, Enable Device Sync, Model providers, and Agent preferences are on. Other data categories, Install missing software, and Sync deletions are off. Review the actual settings on each computer; an existing installation can have different choices.
Model providers includes provider credentials and account metadata. Plugins, when enabled, can include user-scoped secrets. Review these categories when deciding what to share between your computers.
To access a project’s existing files and runtime remotely, connect to its computer. Device Sync transfers the configuration described here; it does not copy project repositories, worktrees, conversation transcripts, or running terminals.

​
Review the choices on each computer

Start with Connect running and Kisuke signed into the intended account. Both computers need to be available to exchange new configuration.
  1. On the computer you want to configure, open Settings → Device Sync.
  2. Wait for the settings to load. Controls are unavailable while disconnected, loading, or saving a change.
  3. Under Data, choose the categories you want this computer to share and receive.
  4. Review Allowed changes separately. Enabling a data category does not also enable installations or deletions.
  5. Keep Enable Device Sync on to synchronize the selected categories. You can configure the categories while the master switch is off.
  6. Wait for each change to finish before making another. If an error appears, follow the settings recovery guidance before retrying.
Changes save when you operate each switch; there is no separate Save button. A change that has not been acknowledged can have an uncertain result. Use Reload to read the computer’s current settings instead of repeatedly toggling it. These choices belong to each computer and do not themselves synchronize. To exchange a category, allow it on the computers involved. A category disabled on one computer is excluded from that computer’s Device Sync.

​
Phone and web controls

The phone app also exposes Settings → Device Sync, under Connections. Phone and web controls operate through a connected computer; they do not turn the phone or browser into a configuration-file host. For deliberate configuration of a particular computer, use its desktop settings. With several computers connected, the remote settings connection is not guaranteed to follow the project you most recently selected.

​
Choose the data to synchronize

The categories cover supported configuration sources. A category name does not mean every harness uses the same format or that every external tool’s settings are included. Project-scoped instructions, skills, commands, plugin configuration, and repository files remain part of the project. Keep those with the project through your normal file or Git workflow.
Device Sync scans user skills in these directories:
  • ~/.agents/skills
  • ~/.claude/skills
  • ~/.codex/skills
  • ~/.config/opencode/skills
  • ~/.gemini/skills
Each skill must be a child folder containing SKILL.md. The folder’s supporting files travel with it. Hidden child folders and top-level symlinks are skipped; a package containing an absolute or escaping symlink is not portable.Synchronizing between computers is separate from Kisuke’s skill links between harness directories on one computer. Check that the intended harness can discover and use the skill after it arrives.
Custom model definitions belong to one Connect installation. Device Sync does not copy them. Configure the endpoint, model ID, and credentials on the computer that will use them.MCP definitions tied to a local application or a detected machine-specific path are excluded. Other definitions can still need a command, package runner, environment variable, or sign-in on the destination. See MCP servers to check the actual connection.Harness availability does not make an OS-specific executable portable. Conductor is excluded from this synchronization path.

​
Allow installations and deletions separately

​
Install missing software

Turn on Install missing software if you want Device Sync to install missing supported harnesses and plugins. Their data category must also be enabled. Installation depends on the destination’s tools, supported installation method, and any required setup. If installation is not allowed, a received item that requires it can remain pending your attention. Enabling Plugins or Harness availability alone does not establish that its software is installed or ready to run. Healthy external harness installations are kept. An externally installed plugin with a different detected version can be left unchanged and reported as needing attention. Inspect the named item rather than assuming all computers now run identical versions.

​
Sync deletions

Turn on Sync deletions only when you want supported local deletions to propagate and deletion records from other computers to remove matching local items. Kisuke asks for confirmation when you enable it. The relevant data category must also be enabled. Deletion can remove provider credentials or configuration entries, move supported skill or definition files into recovery storage, or uninstall software owned by Device Sync. A recovery copy is not available for every kind of item. External software installations are not uninstalled by this path. Turning Sync deletions off blocks deletion records. It does not freeze existing configuration: a synchronized update can still replace an item’s contents, including fields removed in the newer version. Keep backups of configuration you need to recover.

​
Understand updates and progress

Synchronization runs in the background while enabled. Different computers can contribute different items. For competing versions of the same item, Kisuke selects a recorded version; it does not merge the text of a skill or command line by line. Avoid editing the same item independently on several computers while diagnosing a disagreement. During initial setup, the Device Sync step can show discovery, transfer progress, and items needing attention. Continue manually, when offered, lets setup proceed without establishing that every item synchronized. If there is no other computer to copy from, finish setting up this computer directly. Background notices use these labels: A full progress bar counts processed items; it is not proof that every provider, package, or tool works. Check attention messages even when setup says it is ready. Hide Device Sync dismisses the notice; it does not disable synchronization. After sync, return to Zen, open the intended project, and inspect its model picker. A copied provider credential or preferred model does not prove that the destination harness can run that model. Send a small request to check actual access. Likewise, verify a synchronized skill, command, plugin, or MCP server before relying on it for a larger task.

​
Recover from a settings error

For Connect to a device to change these settings, restore the connection to the computer. Let the policy load before interpreting the displayed switch positions as saved choices.If settings take too long to respond, use Reload once the connection is available. See device connection troubleshooting when several workspace tools are also unavailable.
Choose Reload and inspect the returned values before trying again. A missing confirmation does not prove that the computer rejected or never received your change.If the message says the device disconnected, restore its connection, reload, and then apply the choice you still want.
The screen supplies the latest values after rejecting a conflicting change. Review them, then make the intended change again. Do not restore an older set of switches without considering the other client’s changes.
Keep the exact error. For a restart message, reload after the computer reconnects. A storage error needs attention on that computer; repeated toggles do not repair its storage.If stored policy is unreadable or malformed, synchronization can be disabled rather than using the normal fresh-install defaults. Review and save your intended choices after the storage problem is resolved.

​
An item is missing or needs attention

  1. Confirm both computers are signed into the intended account, online, and running Connect.
  2. Check the master switch and the item’s category on both computers.
  3. Confirm that the item is in a supported user-level location. Project-local configuration and custom models are separate.
  4. Read its attention message. Check installation permission, required package runners, local application availability, and any provider or tool sign-in.
  5. Let background sync retry after resolving the cause, then verify the actual provider or tool.
If Kisuke says another device needs an update, check versions and connectivity on both computers. That message can also accompany an unavailable peer; it does not identify the cause by itself. To stop future synchronization on a computer, turn off Enable Device Sync there and wait for the change to finish. Previously copied credentials, files, and installed software remain. Disabling sync is not a credential-revocation or rollback operation.