Ivy Tendril

Features

Parallel Worktrees

Run agents in isolated git worktrees. Keep your main branch clean until you review, approve, and merge changes.

Docs →

Tunneling (Remote & Mobile Coding)

Expose your server securely using Cloudflare Quick Tunnels to monitor and steer agent runs from anywhere.

Docs →

Voice & Rich Input

Dictate prompts using built-in Whisper voice input and attach text files, logs, or documents with drag-and-drop.

Docs →

Plan Annotations

Annotate drafts inline to automatically update plans with revised agent goals.

Docs →

Powerful Code Reviews

Review agent changes, inspect diffs, and approve code with automated verification gates.

Docs →

GitHub Integration & Automated Inbox

Ingest GitHub Issues or jam.dev bug reports via webhooks to turn markdown plans into active jobs automatically.

Docs →

---

Supported Agents

Works with any CLI agent: if it runs in a terminal, it runs in Tendril.

Agent Skills

Extend your favorite AI coding agents with official Tendril engineering and debugging skills.

Quick Start

Install Tendril skills for any supported agent using the universal skills installer:

npx skills add ivy-interactive/ivy-tendril

Or install a specific skill:

npx skills add ivy-interactive/ivy-tendril --skill tendril-debug-plan

Supported Tools & Environments

Install skills for GitHub Copilot in VS Code:

npx skills add ivy-interactive/ivy-tendril --agent github-copilot

Global install (across all workspaces):

npx skills add ivy-interactive/ivy-tendril --agent github-copilot -g

Or copy skills directly to .agents/skills/ or .github/skills/ (project-level) or ~/.copilot/skills/ (global).

Once installed, skills appear in GitHub Copilot Chat under the /skills menu and can be invoked directly as slash commands (e.g. /tendril-debug-plan, /tendril-debug-job, /tendril-review, /tendrillable).

Third-party VS Code agent extensions:

• 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

For full editor integration, install the official Ivy Tendril VS Code Extension for embedded plan dashboards, worktree navigation, and live execution monitoring.

See the VS Code Setup Guide for detailed configuration options.

Install from the Claude Code marketplace:

/plugin marketplace add ivy-interactive/ivy-tendril
/plugin install tendril-skills@ivy-tendril

Local development:

claude --plugin-dir /path/to/ivy-tendril

See the Claude Code Setup Guide for detailed configuration options.

Install plugin via Git URL:

agy plugin install https://github.com/ivy-interactive/ivy-tendril.git

Local installation:

agy plugin install ./

See the Antigravity Setup Guide for detailed configuration options.

Install targeting Cursor:

npx skills add ivy-interactive/ivy-tendril --agent cursor

Or copy skills to .cursor/skills/ (project-level) or ~/.cursor/skills/ (global).

See the Cursor Setup Guide for detailed configuration options.

Install from the Codex plugin marketplace:

codex plugin marketplace add ivy-interactive/ivy-tendril
codex plugin add tendril-skills@tendril-skills

Install using the Gemini CLI:

gemini skills install https://github.com/ivy-interactive/ivy-tendril.git --path skills

---

Install

Download standalone desktop installers (.pkg, .AppImage, .exe) directly from GitHub Releases or run one of the quick install commands below:

macOS / Linux:

curl -sSf https://cdn.ivy.app/install-tendril.sh | sh

Windows:

irm https://cdn.ivy.app/install-tendril.ps1 | iex

Run

Tendril is a desktop application, but the same installation is also a CLI. The two are separate binaries: tendril-app is the desktop app, and tendril is the CLI and the server.

Start the desktop application by launching Tendril from your applications menu (or run the tendril-app binary directly).

Start the daemon headlessly — the HTTP & WebSocket API, no desktop UI:

tendril run

tendril run checks the port and migrates the database first, then serves on 127.0.0.1:5010. Use --port / --host to change that, and tendril serve if you want the bare listener with no pre-flight checks (it is also the command that takes --tls-cert / --tls-key).

Everything else is a subcommand — tendril --help lists them all, and tendril doctor reports on the installation (exit code 0 when nothing is [FAIL], 1 otherwise, so it can gate a script).

---

🏛 Directory Layout

Ivy-Tendril-V2/
├── src/
│   ├── apps/
│   │   ├── tendril-app/            # Tauri desktop app + React frontend
│   │   └── tendril-docs/           # Documentation site
│   ├── packages/
│   │   └── components/             # @ivy-interactive/components + Storybook
│   ├── crates/
│   │   ├── tendril-core/           # Core domain models, SQLite database, worktree engine
│   │   ├── tendril-server/         # Axum REST & WebSocket HTTP server daemon
│   │   └── tendril-cli/            # Command-line interface ("tendril")
│   ├── extensions/
│   │   └── vscode/                 # VS Code / Antigravity IDE extension
│   ├── promptwares/                # Promptware agent definitions & firmware
│   ├── skills/                     # Agent workflow skills
│   └── scripts/                    # Repository setup & test validation scripts
├── docs/                           # Documentation content
├── Cargo.toml                      # Unified Cargo workspace
├── pnpm-workspace.yaml             # Unified pnpm workspace
└── package.json                    # Workspace root scripts

---

🚀 Getting Started

Prerequisites

• Rust (edition 2021)
• Node.js (v22+) & pnpm (v11+)
• Vite+ (vp)
• GitHub CLI (gh)

Quick Start

1. Install dependencies:

   pnpm install
   

2. Build components & UI library:

   pnpm --filter @ivy-interactive/components build
   

3. Run Storybook:

   pnpm dev:storybook
   

4. Build & run desktop app:

   pnpm dev:app
   

5. Build backend crates:

   cargo build --workspace
   

6. Run tests:

   # Web & component tests
   pnpm test
   
   # Rust tests
   cargo test --workspace
   

Visual & Screenshot Testing

To run screenshot verifications and Storybook visual tests locally:

pnpm install
pnpm run install:playwright:deps

---

Community & Support

• Discord: Join the community on Discord.
• Feedback & Ideas: Found a bug or have an idea? Open an issue.
• Show Support: Star this repo to follow along with our development.

---

License

Tendril is source-available and licensed under the Functional Source License (FSL-1.1-ALv2). Agent skills and plugins (skills/, .claude-plugin/, .codex-plugin/, .agents/) are also licensed under the root repository terms (Functional Source License (FSL-1.1-ALv2)).