endo README

项目的 README,来自 github.com/longsurf-ai/endo。合并为一个 markdown 文件:README.md。

Endo logo

Endo

The Higher Order Harness (HOH).
Compose any agent, on the subscription you already have, into any workflow.

Endo: choosing an agent, starting /best-of-n, and the workflow finishing with an answer in the thread

Download for Mac · Quick start · Features · Development guide

Latest release macOS, Apple Silicon License: MIT Build status on main

Higher Order Harness

A harness runs one agent: it sends the prompt, runs the tools and keeps the history. Endo is a Higher Order Harness (HOH). It takes agents as its building blocks, the way a higher-order function takes functions, and composes them freely:

Why Endo? The name comes from endomorphism, a map whose output is the same kind of thing as its input. Endo takes agents and gives you back an agent: every composition answers in a thread you can talk to, dig into and schedule like any other chat.

Quick start

Download Endo for macOS (Apple Silicon), open the disk image, and install Endo. Signed releases update themselves in the background.

To run it from source, install Node.js 24, Bun 1.4.2, and Just, then:

git clone https://github.com/longsurf-ai/endo.git
cd endo
just install --frozen-lockfile
just desktop

Sign in to at least one provider (an existing codex, claude, Antigravity or grok login works, or use Settings → Models), or configure OpenCode's native model providers. Then ask something like "Every weekday at 9 AM, summarize my priorities for the day" and open the Schedule page.

Key features

Any agent, one protocol, your subscription

Endo drives Codex, Claude Code, Antigravity, Grok and OpenCode natively through their own CLIs. Use the accounts you already have, or connect compatible endpoints through OpenCode's native configuration. Settings → Models shows plan usage when the provider exposes it. Every provider streams through one protocol into one harness, so answers, tool calls, permission prompts and history behave the same whichever model you pick, and you can change it mid-thread.

Codex, Claude and Gemini answer in turn in one Endo thread, then Settings → Models shows each provider's plan usage.

Workflows that compose anything

A workflow is a TypeScript file in your workspace. agent() calls any model from any provider, parallel() fans calls out, phase() groups them, and a session ID continues an earlier agent's conversation. Run one from chat and the Workflow card shows every call as it happens. /best-of-n, /multi-turn-debate, /thesis-killer and /hypothesis-race ship as workflows, and schedules run any prompt later, on a cron or once.

A workspace workflow drafts with Codex, Claude and Gemini in parallel, then Claude reviews; the Workflow card shows each call and the final answer.

Dig in, one thread, persistent memory

Select any part of an answer and Dig In: a focused conversation opens beside the thread, and the main thread stays clean. Sessions, runs and Dig Ins persist on your machine, so after a restart every thread and branch is still there, and any agent can pick up where another left off.

Selecting text and choosing Dig in opens a side conversation; after Endo restarts, the thread and its Dig In return and Claude continues where Gemini left off.

Building on it

See the development guide and the code organization guide. Endo is at 0.1.x, so expect breaking changes.

Staying updated

Star Endo to follow releases and help more people discover it.

A cursor clicks Star on the Endo GitHub repository, changing it to Starred.

License

MIT

Credits

Endo began as the core of OpenChart. It credits Jan for the app's design and visual style, OpenCode and Effect, assistant-ui and AG-UI, and shadcn/ui, Radix UI, and Base UI.

endo (longsurf-ai/endo)

正在搜索数据库…

102 ·GitHub
这是什么?Endo 是一个“高阶 Harness”(Higher Order Harness,HOH),也就是统一的聊天应用。它可以把多个编程 Agent(Codex、Claude Code、Antigravity、Grok、OpenCode)组合到同一个对话线程、工作流或定时任务中,并且使用你已有的订阅。
这是聊天应用,还是编程 Agent 本身?这是一个桌面聊天应用,位于各个 Harness 之上。普通的 Harness 只运行一个 Agent,而 Endo 允许你在同一线程中切换 Agent、把任务分派给多个 Agent 同时处理,还可以之后继续其中任意一个 Agent 的会话。
怎么把它跑起来?下载 macOS(Apple Silicon)版本的安装包,打开磁盘映像并完成安装;已签名的版本会自动更新。如果要从源码构建,请先安装 Node.js 24、Bun 1.4.2 和 Just,然后运行项目中的设置命令。
使用 Codex、Claude Code 等 Agent 需要账号吗?需要。你可以使用已有的 Codex、Claude、Antigravity 或 Grok 账号登录,也可以在“Settings → Models”中配置 OpenCode 自带的模型提供商。Endo 会通过各自的命令行工具(CLI),使用你已有的订阅来调用每个 Agent。
它够稳定,能放心用吗?不够稳定。项目目前仍是 0.1.x 版本,README 明确提醒可能会出现不兼容的改动。
它也能在 Windows 或 Intel 芯片的 Mac 上运行吗?目前唯一打包好的版本是适用于 Apple Silicon 的 macOS。README 中没有提供 Windows、Linux 或 Intel 芯片 Mac 的版本;不过由于它基于 Node.js/Bun 构建,从源码运行在其他系统上也许可行。
“Endo”这个名字是什么意思?名字来自自同态(endomorphism),指输出与输入属于同一类事物的映射。Endo 接收的是 Agent,返回的也是一个 Agent,因为每一种组合最终仍然会像普通聊天线程一样给出回应。
Endo 中的“工作流”是什么?工作流是你工作区中的一个 TypeScript 文件。其中,agent() 可以调用任意提供商的任意模型,parallel() 可以把调用分发到多路并行执行,phase() 则用于把这些调用分组。内置示例包括 /best-of-n 和 /multi-turn-debate。
“Dig In”是做什么的?选中回答中的一部分内容并选择 Dig In,就会打开一个只针对这部分内容的专注侧边对话,主对话线程保持整洁。之后任何 Agent 都可以接手这个产生的会话。
我能让任务自动定时运行吗?可以。你可以这样说:“每个工作日早上 9 点,总结我的优先事项”,Endo 的 Schedule 页面就会在之后运行这条提示(或任何工作流),可以按 cron 周期执行,也可以只执行一次。
大小
24.7 MB
星标
102
时长
1个月
提交 · 90 天