Skip to content

usage.en.md

Latest commit

 

History

History
72 lines (45 loc) · 2.35 KB

usage.en.md

File metadata and controls

72 lines (45 loc) · 2.35 KB

中文 | English

Usage Guide

What the two tabs do

Chat Bridge

Used for thread migration, bridge session management, returning by session, and direct moves from one provider to another.

Providers

Used for viewing and managing providers. You can:

  • list known providers
  • see each provider's URL, saved state, config state, current state, and thread count
  • save provider URLs and API keys
  • switch the current provider quickly

One thing to know first

Codex chat visibility depends mainly on threads.model_provider in state_5.sqlite. If the chat list suddenly looks empty after switching providers, the chats are often still there; they are just attached to another provider line.

This tool handles migration and return. It does not create permanent duplicate chats and it does not merge different providers into a single native line.

How provider management works

Save a provider preset

  1. Open Providers
  2. Fill in Provider Name, Base URL, and API Key
  3. Click Save / Update

Saving a preset writes only to the tool's own provider_store.json. It does not change Codex config.toml or auth.json.

Switch providers quickly

  1. Open Providers
  2. Select an existing provider or enter provider details manually
  3. Click Switch Using Form

Before the switch, the tool backs up config.toml, auth.json, and the local provider store, then it:

  • updates the current model_provider
  • updates or adds the matching provider block
  • writes the API key to auth.json if one is provided in the form

Delete a saved provider

Delete Saved Entry removes only the local preset saved by the tool. It does not delete chat threads and it does not aggressively remove provider blocks from config.toml.

How chat bridging works

Start a bridge session

  1. Fully exit Codex Desktop
  2. Open Chat Bridge
  3. In Start Bridge Session, choose the source and target providers
  4. Click Start Session

Return a bridge session

  1. Fully exit Codex Desktop again
  2. Select the target session from the session list
  3. Click Return Selected Session

Backups and records

  • Critical backups: artifacts\codex-chat-bridge\backups
  • Bridge sessions: artifacts\codex-chat-bridge\sessions
  • Provider presets: artifacts\codex-chat-bridge\provider_store.json
  • Runtime logs: artifacts\codex-chat-bridge\logs