A codebase that can help check and repair itself needs a map of its behavior, a way to drive the real product, and evidence that a fix works. This project builds that loop for the OpenHands app, Agent Server and core SDK. Agents reproduce bugs, propose repairs and verify the result; maintainers make the decisions. The map then describes the application as it works now.
The explainer
Self-Healing, from the ground up. Software factories change code at the speed of agents, and that needs a safety net. Five minutes build it one piece at a time, following one real bug: the Git name saved in Settings never reached the agent’s commits (#17899), proven before and after its fix (#18425). Drawn with Manim, narrated with the open-weights Kokoro-82M voice af_heart, with a generated score. Download (MP4, 18 MB) · Narration, scene script and musicSelf-Healing, for the Agent Server. Three safety nets under a codebase that agents change faster than people can read: design review where it matters, constraints on possible code, and self-healing when it breaks anyway. From one promise to the whole map, then three bugs that people using a UI over REST would feel: a goal that kept “running” after a restart (#5627, fixed by #5772), one failed run freezing every window for five seconds (#5633, fixed by #5780), and a settings save that erased stored keys after a key change (#5622, fix in review as #5758). Drawn with Manim, narrated with the open-weights Kokoro-82M voice af_heart, with a generated score. Download (MP4, 15 MB) · Download as ZIP (if your browser plays the MP4 instead of saving it) · Narration, scene script and musicAnd for the SDK: two minutes on what an agent actually sees when it uses it: the map, the control-agent-server CLI, a recipe that caught a bug, and the full replay. Drawn with Manim, with a generated score. Download (MP4, 10 MB) · Scene script and music
Agent Server
The first map: 34 families and 931 sub-features of the Agent Server, driven over REST, WebSocket, the Python client and the TypeScript client. Its full replay: 771 pass, 156 known bugs reproduced, 6 blocked, no surprises. It lives in software-agent-sdk PR #5621.
The next map covers the SDK used in process: the agent loop, LLMs, conversations, condensers, skills, MCP, tools, workspaces and more, in 21 families (S01–S21). It is being drafted now and will be linked here when it is published.
OpenHands app
The OpenHands app (Agent Canvas) is a full part of the Self-Healing Codebase Project: a maintained feature map, a browser-driving CLI, and real before/after evidence. Its presentation and human-readable map also have their own cards on the notebook home page.
The 16 October edition covers 778 behavior IDs in 28 families from PR #18334. Each named scenario separates prerequisites, actions and expectations. Reproduced failures, known issues with missing prerequisites, and checks not run keep their own markers.