terminus-cloud-settings-sync

v1.8.0

Published

21 hours ago

Cloud Services sync the Tabby config and connections across platform devices.

Downloads

240

0High
0Medium
0Low

niceit

terminus-plugin

Tabby Sync Cloud Settings

❤️ If you love the project, please Sponsor it so I will have self-fund to keep it long live development. Thanks so much! ❤️

Plugin for Tabby SSH https://github.com/Eugeny/tabby

With this plugin you could sync your settings (Including saved SSH Sessions) automatically across devices.

Current platforms supported: MacOS Windows Linux

This plugin is FREE of use under public license MIT.

Publishing

Dropbox OAuth uses PKCE, so published builds only need the Dropbox app key; do not embed the Dropbox app secret in the plugin.

http://localhost:53682/dropbox/callback

During connection, the plugin temporarily listens on that loopback address, validates the OAuth state, completes the token exchange automatically, and then closes the listener. Manual callback paste remains available as a fallback if the local port cannot be opened.

Set DROPBOX_APP_KEY in the environment before building, watching, or publishing:

DROPBOX_APP_KEY=your_dropbox_app_key npm run build
DROPBOX_APP_KEY=your_dropbox_app_key npm run watch
DROPBOX_APP_KEY=your_dropbox_app_key npm publish

The environment variable belongs to the build/watch process, not the Tabby process. If a webpack watcher was started without DROPBOX_APP_KEY, stop it and restart it with the variable; otherwise each rebuild overwrites dist/index.js with an empty app key.

For GitHub Actions, store the value as a repository secret named DROPBOX_APP_KEY and expose it only to the publish step:

- name: Publish package
  run: npm publish
  env:
    NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
    DROPBOX_APP_KEY: ${{ secrets.DROPBOX_APP_KEY }}

prepublishOnly fails when DROPBOX_APP_KEY is missing, preventing a release with Dropbox authentication disabled. The app key is compiled into dist/index.js and must be treated as public client metadata, not as a secret.