{"slug": "gitmir-an-open-source-ide-that-fixes-your-claude-development", "title": "GitMir – an open source IDE that fixes your Claude development", "summary": "GitMir, an open-source IDE tool, reads a system's existing code to document its areas, business objects, rules, and states, then provides coding agents like Claude Code, Codex, or Cursor with an approved slice of the system before they write code, and verifies the result against the agreed spec. The tool installs with a single command requiring Node 22.18 or newer, runs locally on localhost:4599, and integrates via MCP with 12 procedures and 14 tools. It is designed to fix development workflows with Claude by ensuring agents work from an accurate model of the system.", "body_md": "GitMir reads the system you already run and writes down what it does — areas, business objects, rules, the states each one moves through. From that it answers what a change would actually affect, hands your coding agent the approved slice before it writes anything, and checks the result against what was agreed.\n\nTHE WHOLE MECHANISM, IN SIX MOVES\n\nCODE\n\nMODEL\n\nIMPACT\n\nDECISIONS\n\nAGENT\n\nVERIFY\n\nYour agent stays yours — Claude Code, Codex or Cursor. What changes is what it knows before it starts.\n\nWANT TO RUN IT YOURSELF?\n\nOne command, then the skills do the work.\n\nThe engine is open source and runs on your machine. Four moves from nothing to a product model your agent works from.\n\n01\n\nInstall it\n\nOne command. Needs Node 22.18 or newer.\n\n```\ncurl -fsSL https://ide.gitmir.com/install.sh | sh\npowershell -NoProfile -ExecutionPolicy Bypass -Command \"irm https://ide.gitmir.com/install.ps1 | iex\"\n```\n\nNode 22.18+ · installs to ~/.gitmir/local\n\nNode 22.18+ · installs to %USERPROFILE%\\.gitmir\\local\n\nWorks in the PowerShell that ships with Windows (5.1), in PowerShell 7 and in Command Prompt. Nothing needs administrator rights: the command goes into your user PATH, not the system one.\n\nIf your organisation blocks running a downloaded script, use the clone route instead — it does the same thing with no installer.\n\nThe installer adds itself to your PATH. Open a new terminal before the next command — a shell reads its PATH when it starts, so the window you just used does not know about it yet.\n\nThe installer adds itself to your PATH. Open a new terminal before the next command — Windows applies the change to new windows only.\n\nTHEN RUNgitmir\n\nIn a new terminal · on your machine · opens localhost:4599 · no account\n\n02\n\nConnect your agent\n\nThis is the step that hands over the skills.\n\ngitmir mcp add\n\nOne command, once, for every project. It writes a line into your Claude config and nothing else — no service, no port, no account.\n\nOR, FROM A CLONE\n\nCloned the repo instead? The gitmir command comes with the installer. From a clone, run this instead — the path is the folder you cloned into:\n\nclaude mcp add -s user gitmir -- node \"/path/to/gitmir-local/mcp.ts\"\n\nclaude mcp add -s user gitmir -- node \"C:\\path\\to\\gitmir-local\\mcp.ts\"\n\nThe path is the folder you cloned into, with backslashes: C:\\Users\\you\\gitmir-local\\mcp.ts.\n\nThe -s user scope is not optional. claude mcp add defaults to local, which saves the registration in whatever folder you ran it from — run it once from the wrong place and your editor opens the project and finds no tools.\n\nThen restart your editor. A client reads its MCP config only at startup, and skipping this is the single most common reason people think it did not connect.\n\nTwelve procedures, as slash commands — building the model, planning work that carries its own checks, running the queue, auditing the spec against the code, porting a stack at parity.\n\nFourteen tools the agent calls on its own: what an object is, what breaks if it changes, what a task would touch, where the code already disagrees with the spec, what needs a person right now.\n\nNothing to paste. The procedures are tools, not text. The agent reaches for one when it needs it.\n\nYou know it worked when claude mcp list shows gitmir as connected, and typing / in your editor lists the skills.\n\n03\n\nSay: set this project up with GitMir\n\nThe agent does the setup itself, because the procedures are tools it can call.\n\nAdds the folder to your dashboard\n\nCreates the task queue — todo → in progress → verify → done\n\nReads the repository once and writes the object context into .gitmir/model/\n\nIt does not ask you to paste anything. It calls the setup tool, sees there is no model yet, fetches the model-building procedure and follows it against your code. What comes out is the product in its own terms — areas, business objects, functions, endpoints, screens, events, journeys, lifecycles — linked by stable ids.\n\nYou know it worked when the project appears on localhost:4599 with a queue, and the Model section has something in it.\n\n04\n\nAsk it something only the model knows\n\nWhat breaks if I change the order status?\n\nWhich business rules govern cancellation?\n\nWhat should be verified for this task?\n\nWhere does the code already not do what the spec says?\n\nWhat needs a person here right now?\n\nThe point is not that it answers — it is where the answer comes from. Every one of these is walked from the object context, in both directions, and opens with a line saying how fresh that context is.\n\nYour dashboard's first screen now shows what those answers cost: how much was served, and how big the files are that the objects in them live in.\n\nNot sure it connected? An MCP server has no screen, which makes a broken setup hard to tell from a working one.\n\ngitmir check\n\nStarts the server exactly as your editor does, asks it what this product is, and prints the answer. From a clone: node mcp-check.ts . model inside the checkout.\n\nWHY EACH STEP EXISTS\n\nGitMir moves product understanding before execution.\n\nNine steps, and each one exists because of what it costs to skip it.\n\nSTEPWHAT HAPPENSWHAT IT PREVENTS\n\n01CODEThe system you already run — the only description of the product that cannot be out of date.—\n\n02PRODUCT MODELObjects, rules, states and dependencies, written into your repository as readable files.Prevents reconstructing the same understanding for every change.\n\n03CHANGEThe request, read against that model rather than against a description of it.—\n\n04IMPACTWhat this actually affects, including the areas the ticket never named.Prevents late discovery — the most expensive kind.\n\n05DECISIONSThe product questions that have to be resolved before anybody writes code.Prevents coding against unresolved business logic.\n\n06AGENT CONTEXTThe approved slice, projected into Claude Code, Codex or Cursor before execution.Prevents an agent executing quickly against the wrong premises.\n\n07EXECUTIONYour agent, your machine, your subscription.—\n\n08VERIFYThe resulting product state, compared against the intent that was approved.Prevents “done in code, wrong in product”.\n\n09EVIDENCEWhat was intended, what changed and what was checked — kept, so the next change starts from it.—\n\nWHAT THE COMMAND INSTALLS\n\nWhat the engine gives you.\n\nYou stop explaining the productIt is on one map — areas, objects, rules, states, screens, events — read out of your code.\n\nEvery question has a screenWhat it does, why it works that way, what a change costs, who owns it, where the model is guessing.\n\nYou see what a change breaks before it is writtenBoth directions: what depends on this, and what this depends on.\n\nThe surprises come out before the demoEvery place the code and the written rules disagree, with file and line.\n\nRework gets a numberWhat a change cost to make, and what it cost to finish after it was first shown.\n\nYour agent stops re-reading the repositorySixteen MCP tools and twelve procedures it asks instead.\n\nDone means verifiedA task closes when its own checks pass, not when the code is written.\n\nDraw it, then see what was builtElements and links on the map become tasks; afterwards the screen shows how much of it is real.\n\nYou know what needs you todayAreas with no owner, findings with no decision, tasks running long, a model behind the code.\n\nIt works before the code existsThe model is built from what you intend to build, and the code is written against it.\n\nOR, WITHOUT THE INSTALLER\n\nNothing here needs the installer. It clones the repository, checks your Node and puts gitmir on your PATH — you can do those three things yourself.\n\nSame engine, same skills, same MCP. What you lose is gitmir as a command, so use the clone line in step 02 to connect your agent.\n\nWhat have you got?\n\n01gitmir-modelA shared model of what this product does, read from the real code and linked by stable ids. Everyone works from what the product IS, not what they remember. Where the code and the written rules disagree, spec-audit records it rather than picking a winner.\n\n02task-plannerSplits the goal into small tasks. Each carries its slice of the model and the checks that prove it — nothing is done on faith.\n\n03task-runnerWorks the queue to empty on its own: todo → in progress → verify → done. Runs the checks for real, and writes the fix task when one fails.\n\nRun them in this order. Each one finishes before the next begins.\n\nIn your editor: type / and pick the skill by name\n\nWhat you end up looking at\n\nThe real thing, running. It walks its own script: the product map, the domains, a checkout end to end, the events, a domain opened into its own diagram, the lifecycle inside it — then an update arrives and it shows what that update touches, what it can break, and whether it knows enough.\n\ngitmir / product-model / livePLAYS ITSELF\n\nLoading product model\n\nThe same render the local app draws from your code\n\nWhat the team sees\n\nEverything runs on your machine. You choose how much of it is copied to the site for other people.\n\nNothing\n\nYour machines talk to each other. Nothing is stored, nobody sees the project from outside.\n\nThe default\n\nThe tasks\n\nThe queue: what each task is and whether it is waiting, running or done. Enough for a client to follow along.\n\nTasks and the map\n\nPlus a copy of the product map — and a link you can send to anyone.\n\nThe local app is the engine. The web layer turns it into team and organizational intelligence.\n\nGitMir runs close to the code, on developer machines. The browser layer carries the selected context, tasks, decisions and execution state to the rest of the team — and a Team or Enterprise implementation extends that same foundation with your integrations, your rules and the views each role needs. Not a place to watch from: a place the work is read from.\n\nLOCAL GITMIRcode · model · agent · MCP\n\nGITMIR CONNECTthe machines and the people, one room\n\nGITMIR TEAMyour services, your pipeline, your rules\n\nGITMIR ENTERPRISEthe answers your organization pays for", "url": "https://wpnews.pro/news/gitmir-an-open-source-ide-that-fixes-your-claude-development", "canonical_source": "https://ide.gitmir.com/opensource", "published_at": "2026-08-25 00:01:19+00:00", "updated_at": "2026-08-25 00:12:47.360056+00:00", "lang": "en", "topics": ["developer-tools", "ai-agents", "ai-tools"], "entities": ["GitMir", "Claude Code", "Codex", "Cursor", "Node.js"], "alternates": {"html": "https://wpnews.pro/news/gitmir-an-open-source-ide-that-fixes-your-claude-development", "markdown": "https://wpnews.pro/news/gitmir-an-open-source-ide-that-fixes-your-claude-development.md", "text": "https://wpnews.pro/news/gitmir-an-open-source-ide-that-fixes-your-claude-development.txt", "jsonld": "https://wpnews.pro/news/gitmir-an-open-source-ide-that-fixes-your-claude-development.jsonld"}}