How l3tchupkt/claudex works
Claudex is a terminal coding assistant fork that runs Claude Code’s tool-and-session workflow against configurable model providers, including OpenAI-compatible services and local inference. Users submit prompts in the terminal; the query engine coordinates model requests and tool use, then the CLI presents results. Documented branches include provider selection, smart routing, Telegram access, and persistent memory. The excerpts support core query, command, session, and state relationships; provider-shim internals and Telegram implementation are not shown, so those links are documented at subsystem level.
Main entry points: Tool.ts Tool system · QueryEngine.ts Query engine · query.ts Query loop · sessionStorage.ts Session storage
Components 17
CLI interaction
- Terminal app
src/ink/components/App.tsx - Slash commands
src/commands.ts - Telegram gateway
src/commands/telegram
Assistant execution
- Query engine
src/QueryEngine.ts - Query loop
src/query.ts - Tool system
src/Tool.ts - Coding tools
src/tools - MCP integration
src/services/mcp/MCPConnectionManager.tsx - LSP integration
src/services/lsp/LSPServerManager.ts
Model access
- Provider shim
src/services/api - Model providers
- Smart router
src/services/api
Sessions and state
- Session storage
src/utils/sessionStorage.ts - Portable transcripts
src/utils/sessionStoragePortable.ts - Runtime state
src/bootstrap/state.ts - Persistent memory
src/memdir
Other components
- CLI user
Connections 18
- CLI user → Terminal app: enters prompts
README.md - CLI user → Slash commands: runs commands
src/commands.ts - CLI user → Telegram gateway: uses gateway
README.md - Terminal app → Runtime state: initializes state
src/ink/components/App.tsx - Query engine → Slash commands: loads commands
src/QueryEngine.ts - Query engine → Tool system: coordinates tools
src/QueryEngine.ts - Query engine → Query loop: uses query loop
src/QueryEngine.ts - Query loop → Tool system: dispatches tools
src/query.ts - Tool system → Coding tools: provides coding tools
README.md - Tool system → MCP integration: supports MCP
README.md - Tool system → LSP integration: supports LSP
README.md - Query loop → Provider shim: requests completions
README.md - Provider shim → Model providers: translates requests
README.md - Smart router → Model providers: selects provider
README.md - Query loop → Session storage: uses session history
src/query.ts - Session storage → Portable transcripts: reads transcripts
src/utils/sessionStorage.ts - Session storage → Runtime state: reads runtime state
src/utils/sessionStorage.ts - Query engine → Persistent memory: supports memory
README.md