ByteStash Handler

ByteStash Handler brings your ByteStash snippets directly into VS Code and keeps them in sync automatically.

Why use it?

• Fast sync between ByteStash and VS Code snippets
• Sidebar-first workflow with one-click Sync
• Auto Sync that follows the same sync lifecycle/events as manual Sync
• Secure storage with VS Code Secret Storage
• Startup auth recovery using saved credentials
• Supports private and public snippets

Features

• Login with server URL, username, and password
• Manual Sync button in the sidebar
• Auto Sync with configurable interval (bytestash.syncInterval, minimum 10s)
• Push new snippets to ByteStash
• Delete synced snippets from ByteStash
• If a ByteStash snippet body is actually a pure VS Code snippet collection JSON object, ByteStash Handler detects it and expands each inner snippet as first-class VS Code snippets.
• You can store a full VS Code snippet pack as one "raw" ByteStash snippet and still get proper prefixes and bodies in VS Code.
• Runtime config reaction for:
  • bytestash.autoSync
  • bytestash.syncInterval

Installation

From VS Code Marketplace

1. Open VS Code.
2. Open Extensions (Ctrl+Shift+X / Cmd+Shift+X).
3. Search for ByteStash Handler.
4. Install extension.

Quick Start

1. Configure server

1. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P).
2. Run ByteStash Handler: Configure Server URL.
3. Enter your ByteStash URL, for example https://bytestash.example.com.

Note: non-localhost URLs must use https://.

2. Login

1. Run ByteStash Handler: Login.
2. Enter username and password.

3. Sync

• Use the sidebar Sync button for immediate sync.
• Keep Auto Sync enabled for background syncing.

Snippet storage path

Managed snippets are written to:

• Linux: ~/.config/Code/User/snippets/bytestashhandler.code-snippets

Legacy snippet files are migrated automatically when needed.

Commands

• ByteStash Handler: Configure Server URL
• ByteStash Handler: Login
• ByteStash Handler: Logout
• ByteStash Handler: Refresh Snippets Now
• ByteStash Handler: Push Snippet to Server
• ByteStash Handler: Delete Snippet from Server

Settings

• bytestash.serverUrl (string, default ""): ByteStash server URL
• bytestash.syncInterval (number, default 10): Auto Sync interval in seconds (minimum 10)
• bytestash.autoSync (boolean, default true): Enable Auto Sync
• bytestash.debugSidebar (boolean, default false): Show sidebar diagnostics

Example:

{
  "bytestash.serverUrl": "https://bytestash.example.com",
  "bytestash.syncInterval": 15,
  "bytestash.autoSync": true,
  "bytestash.debugSidebar": false
}

Development

• Install dependencies: npm install
• Compile once: npm run compile
• Watch extension sources: npm run watch
• Watch tests: npm run watch-tests
• Build production bundle: npm run package

Local extension run

1. Press F5 to launch an Extension Development Host.
2. Run extension commands from the command palette.
3. Use breakpoints in src/extension.ts and related modules.

Tests

• Prepare tests: npm run pretest
• Run tests: npm run test
• In VS Code, keep the watch task running so tests are discovered.

Recommended VS Code extensions:

• amodio.tsl-problem-matcher
• ms-vscode.extension-test-runner
• dbaeumer.vscode-eslint

Troubleshooting

Sync not updating

1. Open View -> Output.
2. Select ByteStash Handler.
3. Check auth and sync logs.
4. Verify bytestash.autoSync is enabled.
5. Click sidebar Sync.

Login issues

• Re-check server URL and TLS.
• For local dev only, http://localhost is allowed.

Linux secret storage issues

• Ensure keyring/libsecret support is installed (libsecret-1-dev).

Links

• ByteStash: https://github.com/jordan-dalby/ByteStash
• VS Code snippets docs: https://code.visualstudio.com/docs/editor/userdefinedsnippets
• BrandtFusion: https://brandtfusion.com

License

© 2026 BrandtFusion. All rights reserved.

This extension and its source code are the intellectual property of BrandtFusion. Unauthorized copying, distribution, or use is prohibited. See LICENSE for complete terms.

Credits

• Jordan Dalby: https://github.com/jordan-dalby
• BrandtFusion: https://brandtfusion.com