返回首页
最新
我最近在运行越来越多的本地编码代理(如Claude Code、Codex CLI、OpenCode等),但遇到了一个瓶颈:协调和状态可见性。
当多个代理在同一个代码库中处理不同的子任务时,终端日志变得难以管理。我发现自己需要一个“任务控制中心”——一个集中式跟踪系统,作为我本地终端会话与高层用户界面之间的桥梁。
我正在测试的架构:
我目前正在尝试使用GitHub Issues作为代理状态的临时后端:
- 会话开始时:代理触发一个钩子,创建或更新一个GitHub Issue。
- 空闲/输出时:代理将其发现或差异作为评论发布。
- 人工干预:我可以通过手机或网页回复该问题,本地CLI会获取评论以继续或调整。
问题:
GitHub Issues(以及Jira/Trello)并不是为AI代理的高频事件循环而设计的。用户体验感觉迟缓,并且没有“流式会话”或“代理心跳”的原生概念。
我想问HN的几个问题:
- 是否有新兴的SaaS或自托管解决方案,能够充当代理的Jira?
- 是否有人在构建与本地CLI集成的自定义“代理仪表板”,还是大家只是将所有内容输出到标准输出?
- 如果你同时管理5个以上的代理在一个代码库中工作,你是如何跟踪它们的进度并进行干预,而不需要在5个终端标签之间切换上下文的?
我已经草拟了一个流程,其中GitHub Issues作为中心(连接Codex、Claude Code和OpenClaw),但我在寻找更具针对性的解决方案。
有没有人看到过解决本地代理控制平面问题的项目?
我管理着8个以上的混合代码库(生产、开发、概念验证),涉及Python、TypeScript和Rust。每个我使用的开发工具——Cursor、Copilot、Claude Code——在单个代码库中都表现出色。但它们都无法回答一些跨项目的问题:
- 哪些代码库没有测试?
- 我的React版本在三个前端项目中是否一致?
- 哪个项目已经好几周没有提交更新?
- 我在哪里重复了FastAPI的模式,而不是共享一个库?
我厌倦了手动检查,因此我构建了Atlas。它是一个Python命令行工具,可以在本地扫描你的代码库,并提供一个组合级别的健康仪表盘。
### 功能介绍
将其指向你的项目,运行`atlas scan`,你将获得如下输出:
```bash
pip install nxtg-atlas
atlas init --name "我的组合"
atlas add ~/projects/api
atlas add ~/projects/frontend
atlas scan
atlas status
```
以下是我8个生产代码库的实际输出:
```
+---------+--------------------+----------+--------+----------+---------------------+
| | 项目 | 健康状况 | 测试数 | 代码行数 | 技术栈 |
+---------+--------------------+----------+--------+----------+---------------------+
| (green) | Dx3 | A 94% | 179 | 164,806 | Python . TypeScript |
| (green) | content-engine | B+ 88% | 23 | 12,552 | Python |
| (green) | Podcast-Pipeline | B+ 88% | 49 | 33,680 | Python . FastAPI |
| (green) | nxtg.ai | B+ 87% | 36 | 49,938 | TypeScript . Next.js|
| (green) | Faultline | B+ 86% | 29 | 15,527 | TypeScript . React |
| (green) | voice-jib-jab | B+ 86% | 58 | 45,311 | TypeScript . Python |
| (yellow)| SynApps | C 67% | 114 | 793,406 | Python . TypeScript |
| (red) | NXTG-Forge | D 59% | 121 | 136,083 | TypeScript . Rust |
+---------+--------------------+----------+--------+----------+---------------------+
8个项目 | 609个测试文件 | 1,251,303行代码 | 扫描耗时31秒
这不是一个模拟图。这是扫描我们生产组合的实际输出。C和D等级的结果令人尴尬——但这正是重点。你无法修复你看不见的问题。
### 健康评分的工作原理
每个项目根据四个加权维度获得A-F的评分:
- 测试(35%)——测试文件数量与源文件的比例
- 结构(25%)——CI/CD、.gitignore、包配置、代码检查、源代码组织
- Git卫生(20%)——提交历史、远程状态、干净的工作树
- 文档(20%)——README、CHANGELOG、docs/等
### 跨项目智能
这就是有趣的地方。Atlas比较你所有代码库中的依赖和版本:
- 共享依赖(fastapi在4个项目中使用,react在3个项目中使用)
- 版本不匹配(一个应用中使用react ^18.2.0,另一个中使用^19.2.1)
- 健康差距(3个项目没有测试,1个项目有50多个未提交的更改)
- 这些问题会在六个月后找上你。
### 它不是
- 不是云服务。没有网络调用,没有遥测,没有账户。
- 不是代码检查工具或代码质量工具。它不会逐行读取你的源代码。
- 不是SonarQube / CodeClimate的替代品。后者深入分析单个代码库,而Atlas则广泛覆盖多个代码库。
### 详细信息
- 支持Python 3.11+,使用Typer + Rich构建
- 状态存储在一个JSON文件中,路径为~/.atlas/portfolio.json
- 检测10种以上的语言,15种以上的框架,5种以上的数据库
- MIT许可证,100%开源——没有层级,没有限制,没有功能门槛
- 一切正常:无限项目、跨项目智能、导出、批量添加
--> GitHub: [https://github.com/nxtg-ai/repoatlas](https://github.com/nxtg-ai/repoatlas)
--> PyPI: [https://pypi.org/project/nxtg-atlas/](https://pypi.org/project/nxtg-atlas/)
如果Atlas能为你节省时间,请考虑支持开发。
欢迎询问有关评分算法、检测启发式或我们内部使用方式的问题。