Numex Codex # Numex Codex ### A coding agent that thinks in Turkish β€” for your editor, terminal and browser. **Ask. It writes, runs and verifies β€” until the job is actually done.** [πŸ‡ΉπŸ‡· TΓΌrkΓ§e](README.md) Β· πŸ‡¬πŸ‡§ **English**
--- Numex Codex is the coding agent of [Numex AI](https://numexai.com.tr), TΓΌrkiye's Turkish-first AI. Tell it what you want in plain language; it **plans, writes, runs and tests** the code, and only says "done" once it can **prove** it works. For complex work it doesn't act alone β€” it convenes a **Council** of four specialists. > πŸ“Œ This is Codex's showcase, documentation and community repo. Downloads: > [codex.numexai.com.tr](https://codex.numexai.com.tr). Open-source SDK: > [numex-sdk](https://github.com/mobilcep/numex-sdk). ## πŸšͺ Four doors, one agent | | Where | Install | |---|---|---| | 🧩 **Codex IDE** | Windows desktop (VS Code based) | [Download](https://codex.numexai.com.tr) β€” v2.9.59, ~162 MB | | 🧩 **VS Code extension** | Your existing VS Code | Install the extension + sign in via CLI | | ⌨️ **Codex CLI** | Terminal | `npm i -g @numexai/cli` (v3.3.10) | | 🌐 **Codex Web** | Browser | Nothing to install | ## πŸ›οΈ The Council β€” four specialists, one task Most coding agents grade their own homework: one model plans, writes, tests and declares success. Codex hands complex tasks to a Council where every member has **one job and limited permissions**: | Member | Job | Can write? | |---|---|---| | πŸ“ **Architect** | Folder structure, data model, per-file function plan | ❌ Plan only | | πŸ’» **Coder** | Writes complete, working code β€” no stubs, no TODOs | βœ… **The only writer** | | πŸ›‘οΈ **Auditor** | First asks *"did we build the right thing?"*, then tests and verifies | ❌ Read & report only | | 🎨 **Designer** | Polishes UI/UX | ⚠️ CSS/HTML only | - **Single-writer rule** β€” only the Coder writes code, so agents never collide. - **Off-topic plan check** β€” if the Architect's plan drifts from your request, the Coder follows *your request*, not the plan. - **Right-sized team** β€” a one-line fix gets no council; a full-stack system gets all four. Token budget is checked up front (trivial β‰ˆ 500 tokens … enterprise β‰ˆ 30,000). - **Summon it yourself** β€” *"konseyi topla"* ("gather the council"). - **Honest report** β€” a plain-language summary of who did what, including anything left unresolved. β†’ [Full Council write-up (Turkish)](docs/konsey.md) ## 🚦 No "done" without proof β€” FinishGate A task only closes with **live evidence**: an HTTP 200 from the running server, passing tests, or the expected DOM in a headless browser. Otherwise the agent returns to a **self-healing loop**. If it gets stuck, a stuck-detector hands control back to you. ## πŸ”€ Four modes **Chat** (explain, answer) Β· **Plan** (no edits, just a roadmap) Β· **Autonomous** (plan β†’ approve β†’ apply β†’ verify) Β· **Bug Hunter** (root cause from logs and output). ## ⌨️ CLI highlights ```bash numex "build a dark-themed todo app" numex plan "add a payment module" # plan only numex mission "make the tests pass" # long-running autonomous mission in sandboxed worktrees numex undo # roll back the last turn numex --offline "…" # local Ollama, no internet numex uzak install # control your PC from your phone ``` Surgical diff-based patching Β· background process error interception Β· BM25 + AST code index Β· MCP client Β· live tree progress. ## 🧠 Transparent memory Every project gets a readable `.numex/` folder: RAG index, **audit trail** of every action, undo checkpoints, learned errors, mission state and token usage. β†’ [docs/numex-klasoru.md](docs/numex-klasoru.md) ## 🀝 Community Bugs and ideas β†’ [Issues](../../issues/new/choose) Β· Show what you built β†’ [Discussions](../../discussions) Β· Security β†’ **destek@numexai.com.tr**