Mlx-Code: A Coding Agent That Speaks Git Natively

Mlx-Code, a new coding agent, natively integrates Git as its core state machine, enabling developers to branch, diff, and resume from any checkpoint. By mapping the reasoning loop onto Git mechanisms, it allows isolated worktrees, concurrent multi-agent execution, and recursive sub-agent spawning. The tool supports multiple APIs and can be used as a library for custom workflows.

00 mlx code A Coding Agent That Speaks Git Natively ✔ Git isn't just a backup. It's a state machine. ✔ Git commits store file changes together with the conversation that produced them. ✔ Parallel worktrees host multiple isolated agents concurrently. ✔ Agents can spawn sub-agents recursively. Branch, diff, and resume from any branching paths dynamically. 01 cli demo 02 why git | Agent | Git | What It Enables | |---|---|---| | Execution step changes files | commit | Inspect changes cleanly with git diff | | Alternative approach | branch | Explore paths non-destructively | | Isolated agent sandbox | worktree | Keep your active checkout clean and safe | | Resuming from a past session | checkout | Rewind agent to any snapshot state | Most agents treat version control as an afterthought. mlx-code maps the reasoning loop directly onto Git mechanisms. Your complete agent state history lives inside git commit history rather than an opaque database. 03 primitives Fork from any checkpoint A branch opens a fresh interactive tab in an isolated worktree. Test divergent code designs securely without abandoning your active checkout. /branch --rev 2 make it use httpx instead Resume from anywhere Every file-changing step is snapshot-committed with the chat/execution history. Rewind cleanly to any checkpoints. mlc --resume abc1234 Switch configs on the fly Swap agent configurations mid-session between planner, coder, and reviewer roles without losing your active context. /clear --config reviewer.yaml Concurrent multi-agent Run multiple agents concurrently inside one batch step. Share your unified memory architecture compute pools dynamically. mlc --engine batch 04 architecture Worktrees: main ──●──●──●──●──●──●──●──●──●──●──●──●──●──●──────► Node = git commit + chat history │ │ │ └── branch-1 ──●──●──● │ │ ┌────────────┐ │ └─┤ branch-1-0 ├──●──● │ └─────┬──────┘ └── branch-0 ──●──●──● │ │ Tabs: ├────────────► Tab = git branch + Agent │ ┌──────────────────────────────────────────────┼─────────┐ │ TUI tabs │ │ │ ┌──────┐ ┌──────────┐ ┌──────────┐ ┌─────┴──────┐ │ │ │ main │ │ branch-0 │ │ branch-1 │ │ branch-1-0 │ │ │ └──────┘ └────┬─────┘ └──────────┘ └────────────┘ │ └─────────────────┼──────────────────────────────────────┘ │ Agents: ├──────────────────────────────────────► Each tab runs its own Agent │ ┌────┴─────────────────────────────────────┐ │ Agent │ │ ┌────────────────┐ ┌────────────────┐ │ │ │ API: │ │ Tools: │ │ │ │ Local mlx-lm │ │ Read Write │ │ │ │ Gemini │ │ Edit Bash │ │ │ │ Claude │ │ Grep Find │ │ │ │ Codex │ │ Ls Skill │ │ │ │ DeepSeek │ │ Agent ─────────┼──┼─► Recursively spawns sub-Agents │ └────────────────┘ └────────────────┘ │ │ Git worktree │ │ isolation + session state │ └──────────────────────────────────────────┘ 05 library api Use as a Library Construct custom workflow pipelines, run programmatic background review checks, or coordinate distributed multi-agent workflows natively on your Mac. python from mlx code.repl import Agent from mlx code.tools import ReadTool, WriteTool, EditTool agent = Agent api='claude', tool names= 'Read', 'Write', 'Edit' result = await agent.run 'refactor utils.py to use dataclasses' 06 user manual slash commands /branch --rev N Fork tab from checkpoint /diff --all Review worktree changes /clear --config F Clear / reset session /history --raw Show chat log /toolsList active tools commandRun a shell command $commandRun an interactive command keyboard shortcuts Ctrl-1 … Ctrl-9Jump directly to N-th tab Ctrl-, / Ctrl-.Cycle adjacent tabs EnterSubmit Ctrl-JInsert newline Ctrl-RRecall last prompt Ctrl-CClear input or abort agent Ctrl-DClose branch tab, or exit app