Skip to content

Coday Desktop Client

Coday is a desktop client that lets you use the AI models of a custom API source (such as TokenFlow) inside Cursor, Windsurf, Devin, and Kiro. It acts as a local gateway, so chat, completion, Agent, and tool calls in your editor keep working as usual.

Platform

Coday currently supports Windows 10 (x64) and above only.

What Coday Can Do

  • Multi-editor support: Cursor, Windsurf, Devin, Kiro — chat / completion / Agent / tool calls all work as usual.
  • Bring your own model and source: Connect any OpenAI / Claude compatible endpoint, sync models with one click, and switch anytime.
  • Multi-source failover: Automatically switches to the next available source when the current one is down.
  • Cross-IDE rule awareness: Automatically reads each editor's rule files in the project (.cursor/rules, .kiro/steering, CLAUDE.md, .windsurfrules, etc.).
  • Remote development: Works with remote hosts connected via Remote-SSH.
  • Network diagnostics: Built-in request viewer, logs, and status panel.

Step 1: Download Coday

  1. Open the Coday repository: https://github.com/HyperClockUp/Coday
  2. Click the latest version (marked Latest) under Releases on the right, or click the Download link in the README.

Open the Coday repo to download

  1. On the Release page, download the Coday_x.x.x_x64-setup.exe installer from the Assets section.

Download the Coday installer

  1. Once downloaded, click Open file in the browser download bar to run the installer.

Open the installer file

Step 2: Install Coday

  1. On the setup welcome screen, click Next.

Coday setup welcome screen

  1. Confirm the install location (the default is fine) and click Next to continue.

Choose install location

  1. When installation finishes, you can check "Run Coday" and "Create desktop shortcut", then click Finish.

Note

You can leave "Run Coday" unchecked for now. If Coday won't start when run directly, use Run as administrator instead (see the next step).

Installation complete

Step 3: First Launch (Run as Administrator)

Important

For the first launch, be sure to use Run as administrator. Otherwise the local certificate may fail to install and the gateway may not start.

  1. Right-click the Coday desktop shortcut and choose Run as administrator.

Run as administrator

  1. On first launch / first gateway connection, a security warning appears asking to install the Coday CA certificate. Click Yes to install it.

Why install the certificate

Coday forwards requests through a local gateway, so a local CA certificate must be installed to proxy HTTPS traffic. This certificate only takes effect on your own machine.

Install the Coday CA certificate

Step 4: Configure the API Source (Relay Config)

  1. On the Coday main screen, click the API endpoint area, or click the Relay button below to open the relay config.

Open relay config

  1. In the source list on the left, select TokenFlow (official). In the Key field on the right, enter the key you generated on the TokenFlow website, then click Save.
  2. Click the Sync button — Coday will automatically sync the source's available models and can query your balance.

Multiple sources active at once

You can keep multiple sources active at the same time (for example, using both GPT and Claude). Click "Set as current" under a source to switch the active source.

Relay config: enter the key and sync models

Step 5: Start the Gateway and Use It in Your IDE

  1. After configuring, return to the main screen. Coday shows "Running", and the local gateway address is usually 127.0.0.1:443. Real-time stats such as requests, tokens, success rate, and latency appear below, along with the traffic breakdown across Kiro / Windsurf / Devin / Cursor / VS Code.

Coday running

  1. Keep Coday "Running", open your editor (such as Windsurf / Cursor), pick a configured model, and chat and develop as usual.

Chatting in the IDE

FAQ

  • Won't run / gateway won't connect after launch: Close Coday and restart it with Run as administrator.
  • The certificate prompt didn't appear, or you clicked "No": Restart Coday as administrator to trigger the certificate installation again, then click "Yes".
  • The model list is empty: Make sure you entered the correct key in the relay config and clicked "Sync".
  • Can't switch modes: You can't switch modes while the proxy is running — stop the proxy first, then switch.
最近更新