Ivy Tendril

面向 10x 生产力构建者的 Agentic 软件工厂

AI 智能体现在可以编写 99% 的代码。这彻底改变了作为开发者的意义。我们的角色转变为掌握何为优质代码。为此，我们需要全新的开发者工具。Tendril 正是这样的工具，它将在智能体时代替代传统的 IDE。

https://youtu.be/_KVG1NnAj-8

## 功能特性

### 并行工作区 (Parallel Worktrees) 在隔离的 git 工作区中运行智能体。在审核、批准并合并更改之前，始终保持主分支的干净整洁。 [文档 →](https://tendril.ivy.app/docs/gettingstarted/introduction)
### 远程穿透 (Tunneling) (远程与移动端开发) 使用 Cloudflare Quick Tunnels 安全暴露您的服务器，随时随地监控和引导智能体运行。 [文档 →](https://tendril.ivy.app/docs/gettingstarted/introduction)
### 语音与富文本输入 (Voice & Rich Input) 使用内置的 Whisper 语音输入口述提示词，并通过拖拽轻松添加文本文件、日志或文档。 [文档 →](https://tendril.ivy.app/docs/gettingstarted/introduction)
### 计划内联批注 (Plan Annotations) 直接在草稿中进行内联批注，自动使用修订后的目标更新智能体计划。 [文档 →](https://tendril.ivy.app/docs/gettingstarted/introduction)
### 强大代码审查 (Code Reviews) 审查智能体的代码变更、检查 diff，并通过自动化验证门禁批准代码。 [文档 →](https://tendril.ivy.app/docs/gettingstarted/introduction)
### GitHub 集成与自动收件箱 (GitHub Integration & Automated Inbox) 通过 Webhook 接收 GitHub Issues 或 jam.dev 缺陷报告，自动将 Markdown 计划转化为进行中的任务。 [文档 →](https://tendril.ivy.app/docs/integrations/jamdev)

--- ## 支持的智能体支持**任何 CLI 智能体**: 只要能在终端中运行，就能在 Tendril 中运行。

Claude Code Codex GitHub Copilot Gemini OpenCode Apple Foundation Models + 任意 CLI 智能体

## 智能体技能 (Agent Skills) 使用官方 Tendril 工程与调试技能扩展您喜爱的 AI 编程智能体。 ### 快速上手使用通用技能安装程序为任何受支持的智能体安装 Tendril 技能: ```bash npx skills add ivy-interactive/ivy-tendril ``` 或安装特定技能: ```bash npx skills add ivy-interactive/ivy-tendril --skill tendril-debug-plan ``` ### 支持的工具与开发环境

Visual Studio Code (GitHub Copilot 与扩展)

为 VS Code 中的 GitHub Copilot 安装技能: ```bash npx skills add ivy-interactive/ivy-tendril --agent github-copilot ``` 全局安装 (适用于所有工作区): ```bash npx skills add ivy-interactive/ivy-tendril --agent github-copilot -g ``` 或直接将技能复制到工作区根目录下的 `.agents/skills/` 或 `.github/skills/` (项目级) 或 `~/.copilot/skills/` (全局)。安装完成后，技能将显示在 GitHub Copilot Chat 的 `/skills` 菜单中，并可直接作为斜杠命令调用 (例如 `/tendril-debug-plan`, `/tendril-debug-job`, `/tendril-review`, `/tendrillable`)。第三方 VS Code 智能体扩展: - Cline: `npx skills add ivy-interactive/ivy-tendril --agent cline` - Continue: `npx skills add ivy-interactive/ivy-tendril --agent continue` - Roo Code: `npx skills add ivy-interactive/ivy-tendril --agent roo` 如需完整的编辑器集成，请安装官方 [Ivy Tendril VS Code 扩展](https://marketplace.visualstudio.com/items?itemName=ivy-interactive.ivy-tendril)，以获取内嵌的计划仪表板、工作区导航和实时执行监控。请参阅 [VS Code 配置指南](../vscode-setup.md) 了解详细配置选项。

Claude Code

从 Claude Code 插件市场安装: ``` /plugin marketplace add ivy-interactive/ivy-tendril /plugin install tendril-skills@ivy-tendril ``` 本地开发模式: ```bash claude --plugin-dir /path/to/ivy-tendril ``` 请参阅 [Claude Code 配置指南](../claude-setup.md) 了解详细配置选项。

Antigravity CLI (agy)

通过 Git URL 安装插件: ```bash agy plugin install https://github.com/ivy-interactive/ivy-tendril.git ``` 本地安装: ```bash agy plugin install ./ ``` 请参阅 [Antigravity 配置指南](../antigravity-setup.md) 了解详细配置选项。

Cursor

面向 Cursor 安装: ```bash npx skills add ivy-interactive/ivy-tendril --agent cursor ``` 或将技能复制到 `.cursor/skills/` (项目级) 或 `~/.cursor/skills/` (全局)。请参阅 [Cursor 配置指南](../cursor-setup.md) 了解详细配置选项。

OpenAI Codex

从 Codex 插件市场安装: ```bash codex plugin marketplace add ivy-interactive/ivy-tendril codex plugin add tendril-skills@tendril-skills ```

Gemini CLI

使用 Gemini CLI 安装: ```bash gemini skills install https://github.com/ivy-interactive/ivy-tendril.git --path skills ```

--- ## 安装直接从 [GitHub Releases](https://github.com/Ivy-Interactive/Ivy-Tendril/releases/latest) 下载独立桌面安装包 (`.pkg`, `.AppImage`, `.exe`)，或运行以下快捷安装命令: **macOS / Linux:** ```bash curl -sSf https://cdn.ivy.app/install-tendril.sh | sh ``` **Windows:** ```powershell irm https://cdn.ivy.app/install-tendril.ps1 | iex ``` ### 运行 Tendril 是一款桌面应用程序，但同一份安装同时也提供 CLI。两者是相互独立的可执行文件：`tendril-app` 是桌面应用，`tendril` 是 CLI 和服务端。从应用程序菜单启动 **Tendril** 即可打开桌面应用程序（也可以直接运行 `tendril-app` 可执行文件）。以无头模式启动守护进程 —— 仅提供 HTTP 与 WebSocket API，没有桌面界面: ```bash tendril run ``` `tendril run` 会先检查端口并迁移数据库，然后在 `127.0.0.1:5010` 上提供服务。使用 `--port` / `--host` 可以更改监听地址；如果需要不做任何预检查的纯监听器，请使用 `tendril serve`（它也是接受 `--tls-cert` / `--tls-key` 的命令）。其余功能都是子命令 —— `tendril --help` 会列出全部子命令，`tendril doctor` 则会报告安装状态（没有任何 `[FAIL]` 时退出码为 0，否则为 1，因此可以用它作为脚本中的门禁）。 --- ## 🏛 目录结构 ``` Ivy-Tendril-V2/ ├── src/ │ ├── apps/ │ │ ├── tendril-app/ # Tauri 桌面应用 + React 前端 │ │ └── tendril-docs/ # 文档站点 │ ├── packages/ │ │ └── components/ # @ivy-interactive/components + Storybook │ ├── crates/ │ │ ├── tendril-core/ # 核心领域模型, SQLite 数据库, 工作区引擎 │ │ ├── tendril-server/ # Axum REST 与 WebSocket HTTP 服务守护进程 │ │ └── tendril-cli/ # 命令行界面 ("tendril") │ ├── extensions/ │ │ └── vscode/ # VS Code / Antigravity IDE 扩展 │ ├── promptwares/ # Promptware 智能体定义与固件 │ ├── skills/ # 智能体工作流技能 │ └── scripts/ # 仓库配置与测试校验脚本 ├── docs/ # 文档内容 ├── Cargo.toml # 统一 Cargo 工作空间 ├── pnpm-workspace.yaml # 统一 pnpm 工作空间 └── package.json # 工作空间根脚本 ``` --- ## 🚀 快速上手 ### 环境要求 - [Rust](https://rustup.rs/) (edition 2021) - [Node.js](https://nodejs.org/) (v22+) 与 [pnpm](https://pnpm.io/) (v11+) - [Vite+](https://viteplus.dev/) (`vp`) - GitHub CLI (`gh`) ### 快速开始 1. **安装依赖**: ```bash pnpm install ``` 2. **构建组件与 UI 库**: ```bash pnpm --filter @ivy-interactive/components build ``` 3. **运行 Storybook**: ```bash pnpm dev:storybook ``` 4. **构建并运行桌面应用**: ```bash pnpm dev:app ``` 5. **构建后端 Crates**: ```bash cargo build --workspace ``` 6. **运行测试**: ```bash # Web 与组件测试 pnpm test # Rust 测试 cargo test --workspace ``` ### 视觉与截图测试如需在本地运行截图校验与 Storybook 视觉测试: ```bash pnpm install pnpm run install:playwright:deps ``` --- ## 社区与支持 - **Discord:** 加入 **[Discord](https://discord.gg/FHgxkDga3y)** 社区。 - **反馈与想法:** 发现了 bug 或有新想法? 欢迎 [提交 Issue](https://github.com/Ivy-Interactive/Ivy-Tendril/issues)。 - **支持我们:** 请为本仓库 [点赞 Star](https://github.com/Ivy-Interactive/Ivy-Tendril) 以关注我们的最新开发动态。 --- ## 许可证 Tendril 是源码可用的，并根据 [Functional Source License (FSL-1.1-ALv2)](../../LICENSE) 获得许可。智能体技能和插件（`skills/`、`.claude-plugin/`、`.codex-plugin/`、`.agents/`）同样遵循根仓库条款（[Functional Source License (FSL-1.1-ALv2)](../../LICENSE)）获得许可。