QuikHubv1 Background Service

QuikHubv1 is a small background service that lets the Chrome extension open local clones of GitHub repositories directly in your IDE.

This application has no UI and runs silently in the background.

1. Install and run the service

• Copy QuikHubv1.exe to a permanent location (for example C:\Tools\QuikHubv1).
• Double‑click QuikHubv1.exe once.
  • No window will appear.
  • The service will start listening on http://127.0.0.1:5173.
  • A Run‑at‑logon entry is added under:
    • HKCU\Software\Microsoft\Windows\CurrentVersion\Run
    • The entry points to the exact path of QuikHubv1.exe.
• From now on the service will start automatically whenever you sign in to Windows.

2. Install the Chrome extension

1. Open Chrome.
2. Navigate to chrome://extensions.
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the extension folder located next to QuikHubv1.exe:
   • Example: C:\Users\<you>\Documents\QuikHub - Copy\extension.
6. Confirm that the QuikHubv1 extension appears in the list and is enabled.

The extension will automatically talk to the local service at http://127.0.0.1:5173.

3. Use QuikHubv1

1. Visit any GitHub repository page in Chrome.
2. Use the extension’s UI (sidebar or popup) to choose:
   • The branch (main by default).
   • The fetch mode:
     • clone to use git clone.
     • zip to download and extract a ZIP snapshot.
   • The IDE (for example vscode).
3. Trigger the Open action.

The background service will:

• Validate owner and repo.
• Check DNS connectivity to github.com.
• For clone mode, verify that git is available.
• Fetch the repository:
  • Clone using git into
    %USERPROFILE%\github-quick-open\{owner}\{repo}
  • Or download and extract a ZIP snapshot into the same location.
• Open the configured IDE at the repository root.

4. Logs and diagnostics

• Logs are written to:
  • %APPDATA%\QuikHubv1\logs\app.log
• The Chrome extension calls the local HTTP API:
  • GET http://127.0.0.1:5173/health
  • GET http://127.0.0.1:5173/ides
  • POST http://127.0.0.1:5173/open

If you need to verify the service manually, you can open PowerShell and run:

Invoke-WebRequest http://127.0.0.1:5173/health -UseBasicParsing

You should see a JSON response with status: "ok".