ITADN
juspay/kolu
README.md
以下内容由 AI 翻译,如有问题请点此提交 issue 反馈

kolu icon

kolu

kolu 是一款为规模化而构建的终端应用:在无限 2D 画布上呈现真实的 xterm.js 磁贴,并配备一个永不丢失的停靠栏——适用于 claudecodexopencodegrok,或你在 shell 中运行的任何内容,尤其是同时运行多个时。

Kolu running in a browser workspace with the dock, terminal tiles, and code panel visible

文档 · 快速入门 · 贡献指南 · AGPL-3.0-or-later

运行

安装 Nix 并启用 flakes,然后:

nix --refresh run github:juspay/kolu

打开 http://127.0.0.1:7681。继续 快速入门最初五分钟

如果首次运行开始编译而不是下载,请启用 kolu 的 二进制缓存 — 参见 快速入门

为什么选择 kolu

不同于将单一模型封装在自有聊天界面背后的智能体指挥中心, kolu 将终端作为通用界面。任何智能体 CLI 均可开箱即用, 且普通 shell 始终仅一条命令之遥。

  • 智能体无关。 无智能体注册表、适配器或供应商锁定。
  • 自动检测,零配置。 kolu 从你已使用的仓库、智能体和 会话中学习,而非要求你重复配置。

阅读完整的哲学

探索

  • 画布、磁贴和停靠栏 — 自由排列真实 终端,然后即时定位其中任意一个。
  • 智能体注意力 — 查看哪些智能体正在 工作、已完成或正在等待你。
  • 持久会话 — 在标签页关闭、服务器重启和重新部署期间 保持 shell 和智能体存活。
  • 远程访问主机 — 从另一台设备访问 kolu, 将其他机器接入同一画布,并 转发端口,以便其中任意一台上的开发 服务器在你的浏览器中打开。
  • 部署 — 在 Linux 或 macOS 上 将 kolu 作为 home-manager 服务保持运行。

完整的特性指南和命令参考位于 kolu.dev。本 README 是地图。

架构

Kolu 将浏览器工作区、Web Shell、工作区状态和实时 PTY 拆分到独立失败和重启的进程中。请参阅权威的 Architecture 页面,了解守护进程栈、线 协议、数据流和包映射。

Development

nix develop
just dev-auto
just test

参见 Developing kolu 以了解本地实例、清理和检查;kolu CI 记录了多平台流水线。

欢迎直接提交 PR 进行 Bug 修复、构建/CI 修复、文档更改以及保持行为不变的代码重构。新的面向用户的功能需要先合并提案。参见 CONTRIBUTING.md

营销网站、产品文档、博客和更新日志位于 website/;其 README 涵盖了编写和 部署。


கோலு 命名, 即一种在阶梯上排列人偶的传统。