A Codex Translation Editor extension that adds a chat interface for the Codex Translation Editor, powered by the BT Servant API. Use it to get translation assistance, ask questions about your project, and keep conversation history tied to your workflow.
Note: This extension is not actively supported by our team. We’re sharing it in case it’s useful. The BT Servant team would love to hear from you if you try it—reach out through servant.bible.
- Chat panel in the Codex Translation Editor activity bar — open the BT Servant view and chat with the BT Servant API in a dedicated webview.
- Streaming responses — replies stream in as they’re generated.
- Session management — export chat sessions to a file and merge them back later (e.g. after reinstalling or moving machines).
- API key in Codex Translation Editor (VS Code) Secret Storage — your API key is stored via the built-in secrets API, not in plain text in settings.
- Optional Codex integration — when used with Codex, the extension can listen for the active cell/context to keep chat relevant to what you’re editing.
- Codex Translation Editor
^1.108.0 - A BT Servant API key — get one at servant.bible; you’ll need it for the chat to work.
-
From source (for now)
Clone the repo, then from the project root:npm install npm run compile
In Codex Translation Editor: Run > Run Extension (or press
F5) to open a new window with the extension loaded. -
Package for install
To produce a.vsixyou can install via Extensions: Install from VSIX:npm run package
The
.vsixwill be in the project root.
| Setting | Description | Default |
|---|---|---|
bt-servant.baseUrl |
Base URL for the BT Servant API | https://api.btservant.ai |
bt-servant.clientId |
Client identifier sent with each request | vscode-extension |
API key is not stored in settings. Get an API key at servant.bible, then set it with the command BT Servant: Set API Key (or run it from the Command Palette). You can clear it by running the same command and submitting an empty value.
| Command | Description |
|---|---|
| BT Servant: Set API Key | Store or remove your BT Servant API key (Secret Storage). |
| BT Servant: Clear Chat History | Clear all chat history in the current session. |
| BT Servant: Merge Sessions from File | Import previously exported sessions from a file. |
| BT Servant: Export Sessions | Export current chat sessions to a file. |
npm install
npm run watch # compile on change
npm run lint # ESLint
npm test # run tests- Main entry:
src/extension.ts - Chat UI & API:
src/chat/(e.g.ChatViewProvider.ts,btServantApi.ts) - Codex integration:
src/codex/stateStore.ts
MIT — see LICENSE.
Issues and pull requests are welcome. Please open an issue first for larger changes so we can align on approach.