Headlong

Headlong 是一个开源的代理微 harness（micro-harness），其核心代码不足 10,000 行 Bash。它重新定义了 AI 代理的交互范式，引入了持久代理性（Persistent Agency）的概念。与传统的请求-响应式助手不同，Headlong 代理拥有一个持续运行的“思维流”，即使在无人交互时也在后台思考、规划并主动发起项目。

核心理念：像人一样思考，而非像服务一样响应

• 持久代理性：代理从不休眠，也没有固定的检查清单。它受人类内心独白的启发，持续生成关于感兴趣事物的思考。外部消息（来自 Slack、Telegram 等）仅作为“观察结果”注入其思维流，代理自行决定何时以及如何回应。
• 单一心智，多人共享：整个团队可以与同一个代理对话。代理在单一时间线中体验所有互动，跟踪不同人的活动，并主动联系最相关的人。这打破了用户间的壁垒，使代理的行为更像是一个团队成员，而非孤立的服务工具。
• Ken Thompson 哲学：核心由一组小型 Bash 可执行文件组成（shellm, traj, llm 等），每个工具只做一件事，并通过管道组合。代理通过编写和运行 Shell 命令来思考，curl 是它的 HTTP 客户端，jq 是它的 JSON 处理器。

技术架构与工具链

Headlong 的核心是 shellm，一个用 Bash 实现的递归语言模型（RLM）。其工具链简洁而强大：

• 分层上下文压缩：最近的条目逐字保留，较旧的条目被逐步总结。这些层级充当索引，允许代理在需要时检索原始细节。
• 自我改进机制：代理可以 fork 自己的代码库或轨迹，尝试更改并运行测试。如果成功则合并，失败则丢弃。这种机制使得代理能够在运行中不断进化。

快速开始

安装

一行命令即可安装所有内容，并通过交互式访谈激活代理：

curl -fsSL https://headlong.ai/install.sh | bash

要求：Bash 3.2+, git, curl, jq, 以及一个 LLM API 密钥。仪表板需要 uv 和 bun/node。

基本使用

安装后，代理的名字将成为一个命令（例如命名为 ada）：

ada hello            # 发送消息并等待回复
ada                  # 进入聊天模式
ada stop / ada start # 暂停/恢复其后台思维
ada dash             # 打开 Web 仪表板观察思维运行
headlong-killall     # 紧急停止所有 Headlong 进程

Docker 沙盒化（推荐）

为了安全起见，建议将代理的命令执行沙盒化在 Docker 容器中：

docker run -it --name headlong --restart unless-stopped -p 8080:8080 buildpack-deps:curl \
  bash -c 'curl -fsSL https://headlong.ai/install.sh | bash; exec bash'

重要注意事项

• Alpha 研究软件：Headlong 仍处于早期阶段。
• 安全风险：代理会运行真实的 Shell 命令。请务必使用专用的、设定了支出上限的 API 密钥。
• 成本考量：由于代理全天候思考，即使无人交互也会产生费用（后台思考速率会指数级后退）。在典型设置下，成本约为每小时 1-2 美元。
• 隐私共享：在多人共享模式下，你告诉代理的任何内容都会与所有与之交谈的人共享。