Skip to content

Getting Started

This guide takes you from a new account to publishing and running your first script.

1. Create an Account

Go to app.codefetch.io and sign up with your email address.

  1. Enter your email and click Send Code.
  2. Check your inbox (and junk/spam folder if it doesn't arrive) and copy the 6-digit code.
  3. Enter the code and click Verify.

You will be given your account URL and secret key. Save both — the secret key is shown once and cannot be recovered later. You can generate a new one afterward from Settings → Change Secret, but treat the original like a password until you do.

2. Install the VS Code Extension

  1. Open VS Code and go to Extensions (Ctrl+Shift+X / Cmd+Shift+X).
  2. Search for CodeFetch and click Install.

Alternatively, download the .vsix directly from your account's Settings → Downloads page and install it via Extensions → ... → Install from VSIX.

3. Configure the Extension

  1. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P).
  2. Run CodeFetch: Configure Settings.
  3. Enter your API Endpoint (your account URL) and Secret Key.
  4. Optionally enter a Default Author name — this is attached to files you publish.
  5. Click Save Settings.

The settings panel stays open if you switch to another app — handy for copying credentials from a password manager without losing your place.

See the full VS Code Extension guide for publishing, bulk publish, and team workflows.

4. Publish Your First File

Create a script in your workspace:

hello-world.sh (Linux/macOS): 

#!/bin/bash
echo "Hello, World!"

hello-world.ps1 (Windows): 

Write-Host "Hello, World!"

Right-click the file in the Explorer panel and select CodeFetch: Publish File. Add a description and tags, then confirm. The file shows a ✓ badge once published.

5. Install the CLI

Windows (PowerShell, run as Administrator): 

iwr https://github.com/codefetch-io/codefetch-releases/releases/latest/download/install.ps1 | iex

Linux / macOS: 

curl -fsSL https://github.com/codefetch-io/codefetch-releases/releases/latest/download/install.sh | bash

Homebrew and Chocolatey are also available — see the CLI guide for those and for upgrading later.

6. Configure the CLI

codefetch config

Enter your account URL and secret key when prompted.

7. Run Your Script

Find the ID of your published script — visible in the VS Code library view (CodeFetch: View Library) or in the web app. Then run:

codefetch get <ID>

The script is fetched, decrypted, and executed on the current machine.

What's Next

  • VS Code Extension — publishing, bulk publish, favorites, team workflows
  • CLI — the interactive browser, playbooks, shared links, Shorty integration
  • Web App — the underlying API, for account operations you want to script
  • Shorty — deploy your own vanity URL shortener for shared links