VS Code Extension
The CodeFetch VS Code extension is where you publish and manage your library. Publish files with a right-click, keep them in sync automatically as you save, and browse your entire library without leaving the editor.
Install
Open the Extensions panel in VS Code (Ctrl+Shift+X / Cmd+Shift+X), search for CodeFetch, and click Install.
Alternatively, download the .vsix file directly from app.codefetch.io and install it manually via Extensions → ··· → Install from VSIX.
Configure
Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and run CodeFetch: Configure Settings.
| Setting | Description |
|---|---|
| API Endpoint | Your CodeFetch account URL |
| Secret Key | Your encryption and authentication key |
| Default Author | Your name, attached to published files |
settings.json or any workspace file. Credentials never appear in source control.
Publishing files
Publish a single file
Right-click any file in the VS Code Explorer and select CodeFetch: Publish File. You'll be prompted for:
- Description — a short summary of what the file does
- Tags — comma-separated, used for search and playbooks
The file is encrypted and pushed to your library. A ✓ badge appears on the file in the Explorer when published successfully.
Publish an entire folder
Right-click a folder and select CodeFetch: Publish Folder. A panel opens listing every file in the folder. Fill in descriptions and tags for each, then click Save All.
- New files are published
- Changed files are updated
- Unchanged files are skipped — nothing is pushed unnecessarily
Auto-sync on save
Once a file is published, saving it automatically pushes the update to your library in the background. If the file content hasn't changed, nothing is pushed.
Auto-sync can be disabled per-workspace in VS Code settings (Ctrl+,):
codefetch.autoUpdateOnChange: false
Unpublish a file
Right-click a published file in the Explorer and select CodeFetch: Unpublish File to remove it from your library.
Visual indicators
Published files show a ✓ badge in the VS Code Explorer. Hover over any badge to see the file's description without opening it.
Managing your library
Open the Command Palette and run CodeFetch: View Library to open a searchable panel of every published file. From there you can:
- Open the file in the editor
- Update its description and tags
- Copy its ID (for use with
codefetch get <ID>) - Unpublish it
Moves and renames
Renaming or moving a published file is handled automatically — the library record updates to match. No duplicates, no broken references, no manual cleanup needed.
Team workflow
Commit the .codefetch/ folder alongside your code. When a teammate clones the repository, ✓ badges appear immediately on all published files — no re-publishing required.
Each repository manages its own files independently. Different repos in the same VS Code workspace don't interfere with each other.
Extension settings
| Setting | Default | Description |
|---|---|---|
codefetch.autoUpdateOnChange | true | Push updates automatically when a published file is saved |
codefetch.autoPublishNewFiles | false | Automatically publish new files without prompting |
Commands reference
| Command | How to trigger |
|---|---|
| Configure Settings | Command Palette |
| Publish File | Right-click file in Explorer |
| Unpublish File | Right-click file in Explorer |
| Publish Folder | Right-click folder in Explorer |
| Update Description and Tags | Command Palette |
| View Library | Command Palette |