ByteStash Handler

The ultimate VS Code extension for syncing and managing your ByteStash code snippets. Keep your snippet library in sync across all your machines, seamlessly integrated into your editor.

Features

• Auto-Sync — Automatically sync snippets from ByteStash (configurable interval, default 10s)
• Push to Server — Create and upload new snippets directly from VS Code
• Secure Authentication — Credentials stored securely via VS Code Secret Storage
• Public & Private — Seamlessly syncs both your private and public snippet collections
• Lightning Fast — Instant snippet retrieval and real-time synchronization
• Smart Sync — Configurable auto-sync intervals to match your workflow
• No External Dependencies — Works perfectly offline after initial setup

Installation

From VS Code Marketplace

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

Quick Setup

Follow these steps to get started:

Step 1️ Configure Server URL

• Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
• Run: bytestash_handler: Configure Server URL
• Enter your ByteStash server URL (e.g., https://bytestash.example.com)

Step 2️ Login

• Open Command Palette (Ctrl+Shift+P)
• Run: bytestash_handler: Login
• Enter your username and password
• Your credentials are securely stored in VS Code's secret storage

Step 3️ Start Syncing

Your snippets will automatically sync to ~/.config/Code/User/snippets/bytestash.code-snippets and be available throughout VS Code!

Commands

Settings

Customize the extension behavior via VS Code Settings (Ctrl+,):

Example settings.json:

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

Links & Resources

• ByteStash Repository — The core ByteStash project
• VS Code Snippets Documentation — Learn about VS Code snippets
• BrandtFusion — Creator's website

Troubleshooting

Snippets not syncing?

1. Check the output channel: Open View → Output and select bytestash_handler
2. Verify your server URL: Run bytestash_handler: Configure Server URL and confirm the URL is correct
3. Re-authenticate: Try running bytestash_handler: Logout followed by bytestash_handler: Login

"Connection refused" error?

• Ensure your ByteStash server is running and accessible at the configured URL
• Check your network connection
• Verify firewall rules allow access to the ByteStash server

Credentials not saving?

• VS Code Secret Storage issues are rare but check that your system keychain/credential manager is working
• On Linux, ensure libsecret is installed: sudo apt-get install libsecret-1-dev

How It Works

1. Authentication: Securely store your ByteStash credentials in VS Code's encrypted storage
2. Auto-Sync: On a configurable interval, the extension fetches updated snippets from your ByteStash server
3. Local Storage: Snippets are saved to your local VS Code snippets folder
4. Push Changes: Create new snippets in VS Code and push them directly to your ByteStash server
5. Seamless Integration: Access your snippets via VS Code's native snippet insertion (Ctrl+Shift+, for inline snippets)

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 license terms.

Credits & Acknowledgments

• Jordan Dalby — Creator of ByteStash
• BrandtFusion — Extension development and maintenance