📂 GistPilot — VS Code Extension

📦 Version: v0.0.4 – Now with Gist QR Sharing, ZIP Import/Export, AI Summarizer, Playground, Star/Fork and more!

✨ Features

✅ Open a GitHub Gist as a folder, preserving nested structure using filenames
✅ Create public or private Gists directly from any file
✅ Add individual files or full folders to an existing Gist
✅ Delete specific files or the entire Gist
✅ Flatten folder paths using ... so Gist can simulate subfolders
✅ Built-in GitHub token authentication with validation
✅ Tokens are stored securely using VS Code's SecretStorage
✅ Works behind firewalls and proxies (no browser dependency)

🆕 v0.0.4 — New Power Features

🔐 Setting Up Your GitHub Token

Creating or editing Gists requires authentication. Follow these steps to create and add your GitHub Personal Access Token:

🔑 How to Create a GitHub Token

1. Go to https://github.com/settings/tokens
2. Click "Fine-grained tokens" → then "Generate new token"
3. Name your token (e.g., VS Code Gist)
4. Set:
   • Expiration: Choose 30 days or "No expiration"
   • Repository access: Doesn't matter for Gists
   • Permissions:
     • Under Gists, check ✅ Read and write
5. Click Generate token
6. Copy the token — you won’t see it again!

🚀 Adding Token to Extension

1. In VS Code, press F1
2. Run GistPilot: Set GitHub Token
3. Paste the token you created

🔐 Your token is securely saved via VS Code’s SecretStorage.

To remove it:
F1 → GistPilot: Clear GitHub Token

🛠️ Usage Guide

📂 Open Gist by ID

• Run: GistPilot: Open Gist by ID
• Paste your Gist ID (e.g., abcd12345)
• It will open as a folder in VS Code

➡️ Supports folder-like files: src...main.cpp → src/main.cpp

✏️ Create a New Gist

• Open any file
• Run: GistPilot: Create New Gist
• Enter description + choose Public/Private
• Gist is created and ID is copied to your clipboard

📁 Upload a Folder to a Gist

• Run: GistPilot: Upload Folder to Gist
• Select a folder from your system
• Enter the target Gist ID
• All files will be uploaded using ... to simulate folder paths

➕ Add File to Gist

• Run: GistPilot: Add File to Gist
• Select file → Enter Gist ID → Done!

➖ Remove File from Gist

• Run: GistPilot: Remove File from Gist
• Enter Gist ID and file name (e.g., src...index.js)

🗑️ Delete a Gist

• Run: GistPilot: Delete Gist
• Enter Gist ID → Gist is permanently deleted

🤖 AI Summarizer (OpenAI & Gemini)

• Run: GistPilot: Summarize Gist with AI
• Select your AI provider (OpenAI or Gemini)
• The extension uses these optional settings:
  • open-gist.aiProvider (default: openai)
  • open-gist.openaiApiKey (OpenAI users)
  • open-gist.geminiApiKey (Gemini users)

💡 Your API key is never saved to disk. For security, it’s used only in memory for the session.

🔐 How to Get Your API Key

🧠 OpenAI

1. Visit: https://platform.openai.com/account/api-keys
2. Log in with your OpenAI account
3. Click “Create new secret key”
4. Copy the key (starts with sk-...) and paste it when prompted in VS Code

🪄 Gemini (Google AI Studio)

1. Visit: https://makersuite.google.com/app/apikey
2. Log in with your Google account
3. Click “Get API key”
4. Copy the key (starts with AIza...) and paste it when prompted in VS Code

🛡️ For privacy and security, your API keys are only used during the current session — they are never saved to disk.

🔁 Toggle Auto-Sync

• Run: GistPilot: Toggle Auto Gist Sync
• This toggles setting: open-gist.autoSync in user preferences

⭐ Star / 🍴 Fork Gist

• Run: GistPilot: Star/Unstar Gist
• In Gist Explorer, right-click a Gist
• Select Star Gist, Unstar Gist, or Fork Gist
• Forked Gist opens in a new workspace window

🧷 Scratch Notes

• Run: GistPilot: Create Scratch Note
• Generates a markdown note with timestamp in your scratch Gist

🖼️ Paste Image into Gist File

• Copy any image (Ctrl+C)
• Focus on a file inside Gist in editor, press Ctrl+V
• Uploads as:
  • File with markdown reference
  • OR embedded base64 block, based on config

🧪 Gist Comment Threads

• Open a Gist file
• Threads are shown below file
• Click to expand, reply, or hide comment threads

🌍 Follow GitHub Users

• Run: GistPilot: Follow GitHub User
• Explore public Gists from followed users in Gist Explorer

🧩 Code Playground (Live Preview)

• Run: GistPilot: Create Code Playground
• Opens an HTML/CSS/JS/Markdown preview with instant updates
• Ideal for quick experiments and sharing via Gists

📤 Share Gist via QR Code / Shortlink

• Run: GistPilot: Share Gist as QR
• Paste your Gist ID or select an active file
• A QR image will be shown in the panel and shortlink copied to clipboard

💡 Great for presentations, mobile scanning, quick sharing.

🧳 Import / Export Gist as ZIP

• Run: GistPilot: Export Gist to ZIP → Select Gist ID → ZIP saved to disk
• Run: GistPilot: Import Gist from ZIP → Select ZIP file → Files extracted and pushed to GitHub
• For Import Feature Github Token is required so first set your github token. 📁 Folder structure is preserved using ... convention. Automatically maps filenames.

🎬 Tutorials (Coming Soon)

• 📹 How to create and set a GitHub token
• 📹 How to upload a folder to a Gist
• 📹 How to use the AI summarizer and auto-sync

📺 Video links will appear here once available

👨‍💻 Maintained by @coderbro

• 🧠 Love the tool? Star it on GitHub!
• 💬 Issues, suggestions, or feature requests welcome.

📄 License

Apache License 2.0 © coderbro

📌 Tags & Topics

🧩 Related Tags (Plain)

#gist #github #gist-explorer #vscode-extension #auto-sync
#openai #code-summary #cloud-snippets #code-sharing #developer-tools
#open-gist #code-manager #ai-powered #vscode-gist #gist-manager
#gist-sync #upload-to-gist #gist-folder #file-sync #vscode-integrations