Sypha AI Docs
Basic Usage

Managing Your Configuration

Backup, share, and manage your Sypha configuration through secure export and import tools.

Configuration Management

Sypha provides robust tools for managing your specialized setups through export, import, and reset functionalities. These features are essential for synchronizing your workflow across machines, sharing team configurations, or troubleshooting environment issues.

Access these controls at the base of the Sypha Settings page, reached via the gear icon in the primary extension view.

Coming Soon !!!

Secure Configuration Export

Selecting Export compiles your entire Sypha configuration into a single JSON file.

  • Included Assets: This includes all active API Provider Profiles, UI preferences, mode calibrations, and context settings.
  • Security Mandate: The exported file contains your individual API keys in plaintext. Never share this file in public repositories or with unauthorized personnel.
  • Workflow: Sypha will prompt you to designate a save location (defaulting to sypha-settings.json).

Configuration Import

Use Import to load a previously archived setup or a standard team configuration.

  • Dynamic Merging: Importing does not overwrite your existing profiles. It intelligently merges the new data—adding new provider profiles and updating global preferences without deleting your unique localized settings.
  • Integrity Validation: Sypha validates the incoming JSON against a strict schema to prevent configuration corruption. You will receive a notification once the merge is successful.

System Reset

The Reset command completely sanitizes your Sypha environment, returning the extension to its factory-default state. This is a high-level troubleshooting action.

  • Destructive Warning: This action is irreversible. It permanently purges all API credentials, custom-built modes, historical task metadata, and personalized preferences.
  • Purge Scope:
    • Provider Profiles: All auth data is removed from secure system storage.
    • Custom Persona: All user-defined modes are deleted.
    • Task Memory: Your entire conversation and task history is cleared.

[!CAUTION] Only execute a System Reset if you intend to start with an absolute "clean slate" or are following a specific technical recovery protocol. We recommend performing a Secure Export before resetting, just in case.


For more on securing your identity within Sypha, visit our Privacy & Security Overview.

On this page