VS Code Extension

Version 1.6.0 — requires VS Code 1.74.0 or later.

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.

SettingDescription
API EndpointYour CodeFetch account URL
Secret KeyYour encryption and authentication key
Default AuthorYour name, attached to published files
Note: Settings are stored in VS Code's SecretStorage — nothing is written to 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

SettingDefaultDescription
codefetch.autoUpdateOnChangetruePush updates automatically when a published file is saved
codefetch.autoPublishNewFilesfalseAutomatically publish new files without prompting

Commands reference

CommandHow to trigger
Configure SettingsCommand Palette
Publish FileRight-click file in Explorer
Unpublish FileRight-click file in Explorer
Publish FolderRight-click folder in Explorer
Update Description and TagsCommand Palette
View LibraryCommand Palette