# Canopy

> Canopy is the IDE, redefined for the agent age — a local-first, memory-light workspace where agent CLIs drive the work, and the IDE shows you what changed and what's running. Traditional IDEs are too heavy; bare terminals are too thin. Canopy is the essentials in between.

Canopy is a native (Rust core, Tauri shell) desktop application for macOS, Linux, and Windows. No Electron, no VS Code fork, no extension host, no server — everything runs as a child process of the app, fully offline. Roughly 5% CPU and 120 MB. It is open source under the MIT license.

## What makes it different

- **Agents are first-class.** Opening a project opens a launcher, not a shell. Pick an agent CLI (Claude Code, Codex CLI, Amp, Aider, Gemini CLI, OpenCode, oh-my-pi) or a plain shell; Canopy starts it `cd`'d into your project with full TUI support. If a CLI isn't installed, it hands you the install command.
- **One window, the whole stack, every agent.** Define a project as labeled components (frontend, backend, workers, android, ios, website), each with its own run commands. Servers start natively into a RUNS rail — services, not sessions — with live status (pulsing dot while live, green check on finish, red exit code on failure).
- **A team of agents, natively.** Every agent gets a native, renameable tab. A sessions panel shows what each agent is doing and costing. Shared context is built in: sessions in a project can see each other's prompts and edited files.
- **Crash resilience.** Canopy tracks every agent session across all terminals; after a crash or restart, reopening runs each agent's own resume so it returns with history intact. One-click Restore or Forget, tracked per project, component, and branch.
- **Git without leaving.** Native side-by-side or unified diffs against HEAD, staging, stash, branches, worktrees, history, and PRs — one rail away from the terminal.
- **No plug-ins, by design.** No bells and whistles — just the essentials. There is no extension marketplace and no third-party code running inside the IDE, which eliminates the supply-chain attack risk that plug-in ecosystems carry.
- **Viewers built in.** Markdown, CSVs, Excel spreadsheets, Word documents, PDFs, and images open natively. Nothing to install or configure — everything works out of the box.
- **Local-first.** Your code, your machine, your agents' API keys — nothing else leaves the box.

## Documentation

- [Homepage](https://canopyide.dev/): Product overview, features, and screenshots.
- [Downloads](https://canopyide.dev/downloads): Installers for macOS (Apple Silicon `Canopy-macos-arm64.dmg`, Intel `Canopy-macos-intel.dmg`) and Linux (`Canopy-linux-x86_64.AppImage`/`.deb`/`.rpm`), served from GitHub releases at `https://github.com/FluidWorksApp/canopy-ide/releases/latest/download/<file>`. Windows installer coming soon.
- [About](https://canopyide.dev/about): Who makes Canopy and why — open source, MIT, maintained by Cause Connect Pte. Ltd. (Singapore), community-funded.
- [Tech Stack](https://canopyide.dev/tech-stack): What Canopy is built with and why — Rust core, Tauri shell (not Electron), TypeScript UI, PTY-backed terminals, native git, and deliberately no plug-in system.
- [Privacy](https://canopyide.dev/privacy): The Canopy app is local-first — no telemetry, no accounts. The website uses analytics; details on the page.
- [Terms](https://canopyide.dev/terms): MIT-licensed, provided as-is.
- [Source & install (GitHub)](https://github.com/FluidWorksApp/canopy-ide): Clone and build with Rust (stable) and Node 20+ — `git clone`, `npm install`, `npm run tauri dev` (or `npm run tauri build`).

## Install

```sh
git clone https://github.com/FluidWorksApp/canopy-ide
cd canopy-ide && npm install
npm run tauri dev   # or: npm run tauri build
```

## More

- [Sponsor / Support](https://github.com/sponsors/FluidWorksApp): Support to keep Canopy independent.
- License: MIT. Maintained by Cause Connect Pte. Ltd., Singapore. Issues and PRs welcome.