https://github.com/DeadWaveWave/opencove
Your infinite canvas workspace for agents, tasks, knowledge, and research. An infinite canvas for Claude Code, Codex, terminals, tasks, and notes.
https://github.com/DeadWaveWave/opencove
agents ai ai-agents canvas claude-code codex desktop-app electron gemini infinite-canvas react typescript
Last synced: 11 days ago
JSON representation
Your infinite canvas workspace for agents, tasks, knowledge, and research. An infinite canvas for Claude Code, Codex, terminals, tasks, and notes.
- Host: GitHub
- URL: https://github.com/DeadWaveWave/opencove
- Owner: DeadWaveWave
- License: mit
- Created: 2026-03-09T11:56:55.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-19T20:41:55.000Z (12 days ago)
- Last Synced: 2026-04-19T22:33:51.067Z (12 days ago)
- Topics: agents, ai, ai-agents, canvas, claude-code, codex, desktop-app, electron, gemini, infinite-canvas, react, typescript
- Language: TypeScript
- Homepage:
- Size: 11.1 MB
- Stars: 1,143
- Watchers: 6
- Forks: 88
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Support: SUPPORT.md
- Agents: AGENTS.md
- Cla: CLA.md
Awesome Lists containing this project
- awesome-cli-agents - DeadWaveWave/opencove - Your infinite canvas workspace for agents, tasks, knowledge, and research. An infinite canvas for Claude Code, Codex, terminals, tasks, and notes. [Terminal] (1kโญ) (๐ AI Tools for Vim, Neovim, and Terminal)
README
# OpenCove ๐
**An infinite canvas for Claude Code, Codex, terminals, tasks, and notes.**
[](./LICENSE)
[]()
[]()
[](./README_ZH.md)
Keep every agent, terminal, task, and note on one infinite canvas.
See parallel work at a glance, keep context visible, and resume exactly where you left off.
[Download the latest builds](https://github.com/DeadWaveWave/opencove/releases) ยท [Read the Chinese README](./README_ZH.md)
## ๐ What is OpenCove?
OpenCove is a **spatial development workspace** for people who work with AI coding agents every day.
Instead of burying work inside tabs, sidebars, and long chat threads, OpenCove puts your **AI agents**, **terminals**, **tasks**, and **notes** on the same infinite 2D canvas, so the full state of your work stays visible.
It is built for workflows like:
- Running multiple `Claude Code` or `Codex` sessions side by side
- Keeping task plans, notes, and terminal output in one shared workspace
- Switching projects without losing layout, context, or execution history
## โจ Highlights
- **๐ Infinite spatial canvas**: Arrange terminals, notes, tasks, and agent sessions the way you actually think.
- **๐ค Built for CLI agents**: Optimized for `Claude Code`, `Codex`, and similar terminal-native agent workflows.
- **๐ง Context stays visible**: Planning, execution, and results live together instead of getting buried in linear chat history.
- **๐พ Persistent workspaces**: Restore your viewport, layout, terminal output, and agent state after restarts.
- **๐๏ธ Space archives**: Snapshot and revisit previous workspace states when you need to jump back into old contexts.
- **๐ผ๏ธ Rich media and smart layouts**: Paste images, multi-select nodes, use label colors, and tidy messy boards quickly.
- **๐ Global search and control center**: Search across the canvas and terminal output, then manage active sessions from one place.
- **๐๏ธ Workspace isolation**: Separate projects cleanly with directories and git worktrees.
## ๐ก Why OpenCove?
OpenCove is designed around a simple idea: **agent workflows are easier to reason about when context is spatial, not hidden**.
| Pain Point (Traditional) | The OpenCove Workspace |
| :--- | :--- |
| **Linear amnesia**: context disappears into long chat histories. | **Spatial context**: important tasks, notes, and execution stay visible on the canvas. |
| **Single-pane bottlenecks**: tabs and split panes force constant context switching. | **Parallel execution**: compare and monitor multiple agents without losing your place. |
| **Opaque automation**: background agent work feels like a black box. | **Transparent actions**: terminals and side effects stay visible while work is happening. |
## ๐ Getting Started
*OpenCove is currently in Alpha. We recommend it for early adopters and power users who want to explore spatial AI workflows.*
### Download
Prebuilt binaries are available on the [GitHub Releases](https://github.com/DeadWaveWave/opencove/releases) page.
At the moment, most public builds are **nightly / prerelease builds**, which means:
- You get the newest features first
- You should expect rough edges
- Feedback and bug reports are especially valuable
Downloads are available for macOS, Windows, and Linux.
> **โ ๏ธ macOS note**
> Current macOS builds are **not signed or notarized** with an Apple Developer ID. If Gatekeeper blocks the app, run this in your terminal:
> ```bash
> xattr -dr com.apple.quarantine /Applications/OpenCove.app
> ```
### Building from Source
#### Prerequisites
- Node.js `>= 22`
- pnpm `>= 9`
- (Recommended) Globally install `Claude Code` or `Codex` to experience full agent workflows.
#### Build Instructions
```bash
# 1. Clone the repository
git clone https://github.com/DeadWaveWave/opencove.git
cd opencove
# 2. Install dependencies
pnpm install
# 3. Start the dev environment
pnpm dev
```
> See [RELEASING.md](docs/RELEASING.md) for more packager and build documentation.
### Web UI (Experimental)
OpenCove includes an **experimental Worker-hosted Web UI** so you can open the canvas from a browser (including other devices on your LAN).
- In **Settings โ Experimental โ Worker Web UI**, turn on **Enable Web UI** (optionally set a fixed port), then start the Local Worker.
- By default it is loopback-only (`127.0.0.1`). For LAN access, enable **LAN Access** and set a Web UI password.
- Dev note: LAN access uses the built `out/renderer` bundle (no HMR). Run `pnpm build` after UI changes.
More details:
- `docs/CONTROL_SURFACE.md`
- `docs/WEB_UI_TROUBLESHOOTING.md`
## ๐๏ธ Technical Architecture
OpenCove is built with modern, high-performance web standards:
- **Framework**: Electron + React + TypeScript (via `electron-vite`)
- **Canvas Engine**: `@xyflow/react` for buttery smooth infinite canvas interactions.
- **Underlying Terminal**: `xterm.js` and `node-pty` powering full-fledged PTY runtimes.
- **Testing**: `Vitest` and `Playwright` for robust unit and E2E regression testing.
## ๐ค Contributing
OpenCove is open source. We need your help to define what the IDE of the AI intelligence era should look like.
Read our guidelines below:
- [Contributing Guidelines (CONTRIBUTING.md)](./CONTRIBUTING.md)
- [Code of Conduct (CODE_OF_CONDUCT.md)](./CODE_OF_CONDUCT.md)
- [Support (SUPPORT.md)](./SUPPORT.md)
- [Trademarks & Brand Guidelines (TRADEMARKS.md)](./TRADEMARKS.md)
## ๐ฌ Community Group
Scan the QR code below to join the OpenCove community group and chat with other users.
---
Redefining dev environments for the modern web.
Built with โค๏ธ by the OpenCove Team.
[](./LICENSE)