ACRYL is a living Agentic Development Environment and runtime for your agents — infinitely adaptive to you, yours to shape, extend and grow into any workflow, any idea, from the inside out, where everything is a plugin.
Bring any coding agent, it plugs in as a replaceable worker, and every decision, diff, and session survives the swap.
⭐ Star ACRYL · Website · Documentation · Download v0.2.0 · Discord
Important
ACRYL is in active early development. Interfaces, workflows, and packaging may change while the first public foundation is established.
You don't use one coding agent anymore. You use Claude Code for this, Codex for that, a terminal agent for the quick fix — and every switch costs you the context, the setup, and the thread of the work.
ACRYL flips the relationship. Instead of your project living inside one agent's chat, agents live inside your project:
Same project
Same context
Same work
Different agents
Claude Code, Codex, OpenCode, Pi, Gemini CLI, DeepSeek Harness agents, ACP-compatible agents, plain PTY tools — even agents that don't know ACRYL exists. They are replaceable workers entering and leaving one persistent development scene. ACRYL owns the workspace, the context, the tasks, and the handoffs.
🖼️ A real canvas, not a chat window. Projects and git worktrees on the left, a tabbed canvas in the middle: agent sessions, native terminals, a file editor, diffs with line-by-line review comments you can send straight back to the agent, a draggable kanban for your notes, docs, and checks. Panes are tiles — open, close, and arrange the environment around the work.
🤖 Every agent, one roster. A built-in catalog of 33 coding agents you can launch into any project, plus your own custom agent definitions. An attention queue tells you the moment an agent needs you (Claude Code hooks ship today), so you can run several and stop babysitting terminals.
🎮 Agents that can drive the app. Agent Control gives the agent inside ACRYL computer-use-style command of ACRYL itself: it reads the accessibility tree, clicks, types, opens panels, enables or disables plugins — every mutating action approved by you per call, recorded in an audit log, stoppable with one key. From the outside, the same power in your terminal: acryl control drives a running app, and acryl doctor / acryl repair diagnose and fix an install that won't boot, with backups and undo.
🧩 Everything is a plugin — really. Built on Cordis, the meta-framework of spatiotemporal composability. Install and hot-reload plugins live across all three surfaces without restarting. Plugins can contribute their own canvas tab types, tools, slots, and services. Browse the ecosystem at cordisplugins.github.io.
🥤 Blends: whole setups, shareable. A Blend is a complete, pullable composition of plugins — an entire opinionated environment as one unit. ACRYL itself is just one Blend, the maxed-out one. Yours can be another. See acrylblends.github.io.
🖥️ Three surfaces, one brain. Desktop (Electron), local Web (acryl web), and the terminal UI are peers rendering the same runtime — same project model, same plugins, same capabilities. Use whichever fits the moment; the work is the same.
The three surfaces are deliberately separate installs — installing one never silently installs or starts another.
| Platform | Desktop download |
|---|---|
| macOS — Apple Silicon | DMG |
| macOS — Intel | DMG |
| Windows — x64 | Installer |
| Linux — x64 / Debian | DEB |
| Linux — arm64 / Debian | DEB |
The Desktop app carries the runtime it needs; it does not add acryl to your PATH or leave a web server running after exit.
One command, no Node.js required, adds acryl to your PATH and verifies the checksum:
curl -fsSL https://acryl.dev/install | bash
acrylPrefer npm? It works, but npm 11+ prints advisory install-scripts warnings for ACRYL's native dependencies (node-pty, koffi, and others). These are npm security notices, not ACRYL errors. To install without them:
npm install -g acryl --allow-scripts=@deepseek-ai/dsh-subprocess-local,@google/genai,koffi,node-pty,protobufjs
acrylacryl webStarts a local web runtime, prints its URL, and serves until you stop it. It is not a hosted cloud service.
nix run github:acryldev/acryl # TUI, built from source
nix run github:acryldev/acryl#acryl-desktop # Desktop GUI
nix profile install github:acryldev/acryl # install to your profileThe flake exposes packages.<system>.acryl (also #default), .prebuilt (prebuilt binary with bundled Node runtime; x86_64-linux, aarch64-linux, aarch64-darwin), .acryl-desktop, and devShells.<system>.default.
- Agent sessions are disposable. Project context is persistent.
- ACRYL owns continuity. Agents perform work.
- Canonical state is durable and agent-independent.
- Agent-specific context is a projection, not the source of truth.
- Everything practical is a plugin or replaceable capability.
- Capabilities are versioned, permissioned, testable, and auditable.
ACRYL product surfaces
Desktop · CLI terminal · Local Web
|
ACRYL-owned capabilities
(workspace, agent control, continuity)
|
DeepSeek Harness capability substrate
(sessions, agents, tools, LLMs, PTYs)
|
Cordis lifecycle and composition runtime
|
Node.js / Electron / OS
The trusted kernel stays small and boring. New functionality arrives as versioned capability packages that can be validated, activated, observed, and rolled back without touching the core.
ACRYL builds on an unmodified, pinned DeepSeek Harness checkout as its capability substrate — sessions, tools, PTYs, sandboxing, Web composition — while remaining an independent product with a broader goal: persistent, cross-agent development continuity. The pinned upstream lives read-only in deepseek-harness/.
ACRYL is not affiliated with, authorized by, or endorsed by DeepSeek.
Requirements: Node.js ^22.19.0 or >=24.0.0, Corepack (selects the pinned PNPM 11.11.0).
corepack pnpm run upstream:sync
corepack pnpm install --frozen-lockfile
corepack pnpm devcorepack pnpm dev builds and launches the isolated local Desktop (own ~/.acryl-dev home, advanced mode, Development Canvas). Other essentials:
corepack pnpm run verify— fast headless loop (typecheck + tests)corepack pnpm run check— complete headless gate, use before handoffcorepack pnpm run web/corepack pnpm run tui— the other surfaces
Repository layout: apps/ (the surfaces), runtime/ (the stable core), plugins/ (replaceable capability packages), distribution/ (release shims), deepseek-harness/ (pinned upstream submodule — never edited from a feature branch).
- Website: acryl.dev · Documentation: acryl.dev/docs
- ACRYL Blends: acrylblends.github.io · Cordis Plugins: cordisplugins.github.io
- Discord: discord.gg/cY9KXMex69
- Cordis: github.com/cordiverse/cordis · DeepSeek Harness: github.com/deepseek-ai/deepseek-harness
ACRYL welcomes contributors interested in agent interoperability, persistent context, Cordis plugins, developer tooling, terminals, editors, dynamic UI, security, and self-extensible software.
Before contributing, read AGENTS.md, the ACRYL orientation, and the Cordis specification. Join the Discord to discuss the project.
ACRYL is licensed under the MIT License.
ACRYL builds on the work of the Cordis community and continues architectural inspiration from DeepSeek Harness. We are grateful to both projects and to the broader open-source coding-agent ecosystem.