{"repo":"Tiendil/donna","free":true,"listed":false,"github":"https://github.com/Tiendil/donna","clone":"git clone https://github.com/Tiendil/donna.git","description":"A CLI tool that helps agents keep long-running work on a predefined path.","language":"Python","stars":27,"topics":["agents","codex","coding-agents","orchestration","skills","state-machines","cloud-code","cursor","engineering","planing"],"license":"BSD-3-Clause","category":"workflow-automation","readme_excerpt":"Donna A CLI tool that helps agents keep long-running work on a predefined path. Donna exists because agent work has a control-flow problem: 1. Most development work is repetitive on the meta level: \"run this tool, do something with the output, run another tool\" or \"implement function A, implement tests for function A, implement function B, …\". 2. Some parts of that work require advanced reasoning, others do not. 3. Agents are almost good at reasoning, but not so good at keeping the whole process in mind, remembering what they did, etc. 4. Therefore, we should separate the reasoning part from the control flow part — let agents focus on what they are good at, and keep the control flow to traditional automation tools. Donna runs predefined workflows as deterministic state machines, so the agent can focus on reasoning, code generation, and other agentic work. You define a workflow in a single readable Markdown file. The agent asks Donna to guide it through the workflow, and Donna keeps the session state, chooses the next operation, and tells the agent what to do or report next. Workflows can start child workflows, be generated on the fly, or be modified while executing. For example, you can have a workflow that guides the agent through the planning process, and at the final step, the agent can generate a new workflow with a detailed plan to execute and run it immediately. As a bonus, Donna saves tokens because the agent does not need to reason about control flow or how to execute","default_branch":null,"files":null,"tree":[],"storefront":"/r/Tiendil","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/Tiendil/donna/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}