Annodex

Browser workspace for Codex — compatible with any LLM provider, no VPN required.

What is Annodex?

Annodex is a browser workspace around Codex. It brings the power of AI-assisted coding and analysis into your browser, removing the friction of terminal-only interaction and provider lock-in.

The Problem

Codex is a powerful agent framework, but accessing it has real barriers:

Codex Desktop requires a ChatGPT Plus/Pro subscription and network access that many users (especially in China and restricted networks) cannot easily obtain.
Codex CLI is terminal-only. No image viewing, no file preview, no visual feedback. Scientists, bioinformaticians, and non-developers face a steep cliff.
Provider compatibility: affordable models like DeepSeek use the chat/completions API format, but Codex requires the OpenAI responses format. Making them work together without a translation layer is painful.

How Annodex Solves This

Annodex wraps Codex in a browser workspace and adds a provider normalization layer:

Problem	Annodex Solution
VPN / ChatGPT required	Works with any LLM provider — just configure your API key
CLI-only, no visuals	Full browser UI with image viewing, file preview, and rich output
DeepSeek / alternative models incompatible	Provider layer translates chat/completions ↔ responses automatically
Sessions scattered across terminals	Auto-archives chats by project directory
Hard to configure models	Visual model config UI — no JSON editing required

Key Features

🔄 Full Codex CLI Compatibility — reads the same ~/.codex config and chat history. Your existing Codex setup works immediately.
🧠 Any Provider, Any Model — DeepSeek, OpenAI, Anthropic, and more. Configure once in ~/.config/annodex/providers.json.
📁 Project-First Organization — chats, files, and outputs are grouped by project directory. Perfect for managing multiple bioinformatics pipelines.
🎨 Generative UI — renders Mermaid diagrams, data tables, and rich Markdown inline. Visualize workflows and analysis results without leaving chat.
🧬 Bioinformatics-Aware — understands pipeline execution logic, generates workflow diagrams, and tracks analysis provenance.
🛠️ Skills & Tool Presets — equip the agent with domain-specific tools for single-cell analysis, variant calling, and more.

What It Looks Like

Annodex combines chat, generated visual output, file preview, model settings, and runtime monitoring in one browser workspace.

Annodex chat workspace with generated chart and tools panel

The same workspace is usable from mobile browsers when Annodex is opened from another device on your network.

Architecture

Browser (Chat + Files + UI)
     │
     ▼
Next.js Server (API wrapper + SSE transport)
     │
     ▼
Codex app-server (Threads + Turns + Tools)

Annodex sits between the browser and Codex, handling provider normalization, session lifecycle, and streaming events. The result: a familiar chat interface with the full power of Codex underneath.

Get Started

Head to Quick Start for installation instructions, or dive into Models to configure your first provider.