Autoloom README

The project's README from github.com/GanyuanRan/Autoloom. As one markdown file: README.md.

Autoloom

Governance Engineering for Coding Agents

Free desktop client · Your choice of model · Windows x64 Beta

Latest release, including Beta Windows x64 Documentation in Chinese and English

TypeScript Electron React Aegis Governance

Website · Download Beta · Documentation · Feedback & ideas · 中文

40-second real-task demo

https://github.com/user-attachments/assets/7a5f00f4-2761-452f-a122-0ee6ef01c3f0

Watch on the website →

ConversationSettings
Autoloom Conversation Autoloom Settings

AI coding with engineering judgment built into execution.

Autoloom brings Aegis’s core governance methods into the coding runtime: question whether a change is needed, challenge assumptions before editing, and review delivery against requirements and execution evidence.

Spend less time reminding your agent to investigate first, avoid unnecessary complexity, and show what it actually verified.

Reasoning at the points where decisions matter

Method Its role in the development workflow
First principles and change necessity At task initiation, examine goals, facts, existing capabilities, and constraints to establish why a change is needed and whether an adequate solution already exists.
Anti-entropy and structural complexity checks Before changes, examine duplicated responsibilities, unnecessary layers, and maintenance burden so added complexity addresses a concrete problem.
Counterexample review and causal diagnosis Before changes, examine conditions that could invalidate a solution; after execution failures, require diagnosis grounded in observations and evidence.
Implementation conformance and completion review Before recording results, compare task requirements, actual execution, and verification material, stating what is complete and what remains unverified.

Autoloom delivers these method requirements at the relevant points, checks prerequisite ordering for key operations, and retains process records. Whether a method was applied well and a result is reliable still needs to be judged from code, execution results, and verification evidence.

Before an admitted project mutation runs, the conversation can show a collapsed Governance impact row describing how the relevant methods changed that concrete action. Its user-facing fields follow the request language, and the complete recorded details remain inspectable.

Recorded project goals, constraints, and key decisions stay with the project. Changes to those decisions present a specific diff for your review. You can also configure a test-first preference and code complexity thresholds to reflect your project's requirements.

From engineering methods to execution

Aegis (GitHub) is our open-source AI engineering method pack. Autoloom integrates its core governance methods into development, covering change necessity, complexity, causal diagnosis, and delivery review.

Guidance loads as needed. The runtime maintains prerequisites for key actions, task state, and execution evidence—connecting governance to actual work and reducing repeated reminders and manual checks. Reliable delivery still depends on actual verification results.

Built on DeepSeek Harness, with our own approach to development

Autoloom is built on DeepSeek's official open-source DeepSeek Harness dsh-v0.1.1-rc.2, at source commit b150a551, retaining the Cordis plugin mechanism.

We will continue following official upstream releases and learning from worthwhile improvements. Changes that fit Autoloom and solve real problems will be adopted after adaptation and verification; selected later reliability fixes are already included.

We also maintain our own product direction: bring engineering judgment into automated development, ground the process in evidence, make results inspectable and keep reducing the user's supervision burden. Autoloom has its own version numbers and release cadence.

We thank DeepSeek Harness, Cordis and the related open-source projects for their contributions. The client retains third-party licenses and copyright notices.

Where we are headed

Become a trustworthy, fully automated AI software development platform.

Help ideas progress through requirements, design, implementation, verification, and continued iteration. Make more of that work autonomous while keeping key decisions, supporting evidence, and delivered results inspectable.

That ambition comes with an ongoing question: how can we achieve the best possible balance of cost, speed, and quality?

We care about the total cost of reliably delivering a requirement: model calls, waiting time, human supervision, and rework caused by defects. Reducing unproductive attempts and repeated context, and directing verification effort toward what matters to the result, are continuing priorities. Different tasks need different tradeoffs. We aim to improve how much of all three can be achieved together and test those improvements on real tasks.

Autoloom is in Beta. Fully automated development and a better balance across these three dimensions are goals we are working toward.

macOS and Linux desktop clients are planned, so you can use Autoloom on your preferred operating system. Windows x64 is currently available; progress on macOS and Linux will be announced in this repository.

Follow what comes next

If you want AI development to include this kind of engineering judgment, ⭐ Star Autoloom to support its continued development. Follow the link to the top of the repository, then click Star in the upper-right corner.

For new releases and repository activity, select Watch → All Activity at the top right of this repository. You can adjust notification delivery in GitHub settings. Use Star to bookmark and show support; use Watch to subscribe to notifications.

Get started

  1. Go to Releases and download the Windows x64 installer, Autoloom-<version>-win-x64.exe.
  2. Install and open Autoloom. Add your model provider and API key in settings, then select a default model.
  3. Open a test project you have backed up and start with a clearly scoped change.

The client is free; your chosen provider bills model usage.

The workspace supports local projects and Linux x64 projects connected over SSH, with project files, code diffs, command logs, previews, and docked interactive terminals. Remote environment requirements are listed in the Beta notes below.

Web search works in local and SSH projects through built-in public Parallel/Exa MCP services, without a separate search API key. Direct page reading supports proxy Fake-IP DNS while retaining public-network access checks. Anonymous search remains subject to upstream limits.

The installed client supports background checks and downloads for Beta updates. Once a download is ready, click “Restart to update” to install and reopen the client. Finish or stop active tasks first; ordinary exit does not install an update. Users of the older extracted ZIP must install the first installer release manually.

The user documentation covers model providers, permissions, local and SSH projects, Session backup, updates, and troubleshooting.

Project information

Bring a real task and try it

Tell us through Issues what Autoloom helped you finish, which steps still needed repeated reminders, and where you hesitated to accept its results. Your actual experience will help us choose what is most worth improving next.

When reporting a problem, include the version, system information, reproduction steps, and expected and actual results. Remove keys, access tokens and personal information before sharing logs or screenshots.

LINUX DO

This repository is Autoloom's official hub for downloads, release notes and feedback.

Autoloom’s client source code is not currently public. As the project evolves, we’ll evaluate what to open source and how, taking community feedback and sustainable maintenance into account. The current closed-source approach is not a commitment to staying closed source permanently. We’ll share concrete plans in this repository when they’re ready.

Beta notes and validation scope
  • The current release is a Windows x64 test build. Data formats may change during Beta; back up important projects and task records before upgrading. Incompatible versions will provide manual upgrade instructions.
  • SSH remote projects support Linux x64 and require a working SSH connection and Node.js 22.x, version 22.19 or later. Restricted commands also require a working Bubblewrap sandbox backend.
  • The installer has no Windows code signature, so Windows may show an unknown-publisher or SmartScreen prompt. Download from this repository's Releases and verify the checksum without disabling system security features.
  • Each release provides SHA256SUMS. Check the file with PowerShell using Get-FileHash -Algorithm SHA256 <installer-path>.
  • Consult each Release for its changes and validation scope. Keyless installation, update, or interface checks do not establish that real-model end-to-end tests passed.

Autoloom (GanyuanRan/Autoloom)

Searching Database…

这是什么?Autoloom 是一个桌面 AI 编程客户端,它把 Aegis 工程治理方法直接融入智能体的执行循环,让代码变更在交付前经过必要性检查、复杂度审查和基于证据的诊断。
这是云服务,还是需要安装的东西?它是一款可免费下载的桌面应用,目前是 Windows x64 的 Beta 构建,需要你自带模型供应商,而不是使用托管云智能体。
怎么让它跑起来?从仓库的 Releases 页面下载 Windows x64 安装程序,安装并打开 Autoloom,然后在设置中添加你模型供应商的 API 密钥并选择默认模型。
需要我自己的 API 密钥吗?需要。Autoloom 本身免费,但你必须连接自己的模型供应商;应用不向你收费,模型调用由你的供应商计费。
安装上有什么坑,或有哪些不完善之处吗?Windows 安装程序尚未进行代码签名,你很可能会看到 SmartScreen 或“发布者未知”警告;请校验发布版的 SHA256 校验和,而不是关闭 Windows 安全功能,并且要有 Beta 数据格式仍会变动的心理准备。
它支持哪些平台?能在远程 Linux 机器上干活吗?目前只有 Windows x64 客户端,macOS 和 Linux 客户端在计划中但尚未发布;你仍然可以通过 SSH 在远程 Linux x64 项目上工作,这要求远程机器装有 Node.js 22.19+。
Aegis 是什么?Aegis 是该团队另一个开源的 AI 工程方法包,涵盖变更必要性、复杂度检查、因果诊断和交付评审。Autoloom 把这些方法直接集成进编程运行时,而不是让它们停留在文档里、还得提醒编程智能体去遵守。
DeepSeek Harness 是什么?为什么这里要提到它?Autoloom 构建在 DeepSeek 开源的 DeepSeek Harness 运行时(dsh-v0.1.1-rc.2)之上,保留了其 Cordis 插件机制;Autoloom 团队在其上叠加治理功能,并单独跟踪有用的上游修复。
Autoloom 的源代码开放吗?不开放。客户端源码目前不公开,这个仓库只作为下载、发布说明和反馈的官方中心,不过团队表示闭源不一定永久持续。
智能体编程时能搜索网页吗?可以。内置的 Parallel 和 Exa MCP 服务为本地和 SSH 连接的项目提供网页搜索,无需你另行提供搜索 API 密钥。
What are similar projects?cocode, zuse, qwen-code, Baize, acryl, claurst, kimi-code, open-swe
Creator
GanyuanRan
Size
12.2 MB
Stars
1K
Updated
CommitOct 18
Age
18d
Commits · 90 Days