# CluxMate

An AI coding agent with a single Python core and three interchangeable front ends, a headless CLI, a Textual TUI, and an Electron desktop app, that speaks any OpenAI-compatible API.

CluxMate is an AI coding agent that reads a codebase, plans changes, edits files, runs commands and answers questions, built as one Python core driving three front ends: a headless CLI for scripts and CI, a full interactive Textual TUI, and an Electron desktop GUI that talks to the same core over JSON-RPC. Because it speaks the OpenAI-compatible API, it works with DeepSeek, Qwen, GLM, OpenAI, OpenRouter, Ollama or any self-hosted endpoint, with per-turn cache-hit and latency metrics shown in the UI.

Sessions are event-sourced: every session is an append-only log, message history is derived from it rather than stored separately, and every turn and tool call is bracketed so the exact prompt at any step can be reconstructed and replayed. Context compaction rewrites a summary region without erasing the underlying events.

Tools are risk-tiered as safe, write, dangerous or critical, with four permission modes and persistent always-allow lists for specific commands. It is written in Python and licensed under MIT.

Website: https://github.com/r1c7/CluxMate