Skip to content
acryldevPublic

About

ACRYL (Agent Context Relay Yielding Lifecycles) is a platform for agentic apps: build them with any coding agent inside, run them as desktop, web, cli-tui or deploy to cloud, share them as Blends. Every feature is a swappable plugin. Each app is a Blend of swappable plugins with coding agents built in.

Topics

Resources

Code of conduct

Contributing

Stars

276 stars

Watchers

8 watching

Forks

Latest commit

 

History

3,557 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ACRYL logo

ACRYL: everything is a plugin. Build agentic apps.

Let your users build the product they need.
Every ACRYL app has its own agent. Your users say "add XYZ", and seconds later the change is live for them and their team. You keep shipping the foundation; they keep their layer.

Website · Get started · Blends store · Cordis Plugins · Discord

Star ACRYL on GitHub acryl on npm MIT License Join Discord

What ACRYL is

Build agentic apps from plugins. Start blank, grow with an agent, share what you make. ACRYL is the open platform and framework underneath: the agent is one part of your app, and our own IDE (ACRYL ADE) is one app built on it.

Start in one command

You need Node.js 22.19 or newer, npm and git. Nothing to install first: npx fetches ACRYL when you run it.

Command What it opens
npx acryl ACRYL Control Center in your terminal: your apps, the Blends store, make, start, share, pull, deploy
npx acryl --gui ACRYL Control Center as a desktop app
npx acryl --web ACRYL Control Center in your browser
npx acryl new my-app A blank app with the agent inside it
npx acryl new my-app --from acrylblends.csv-explorer An app made from a Blend in the store, yours to change

npx acryl --tui is the same as npx acryl. Prefer a download? ACRYL Control Center for macOS, Windows and Linux: Releases.

How your users build: five steps

  1. Building blocks, not source code. Every app is assembled from Cordis plugins: UI, data and actions behind stable services.
  2. The agent builds with those blocks. ACRYL's chat, and Claude Code, Codex or Pi, operate the app through its door. The core code stays untouched.
  3. Sandboxed per person. Every app runs in its own instance, on your machine or in your own WebBox, with your rights only.
  4. Your change is a versioned layer: a Blend. Save, roll back, share it to GitHub, list it in the store.
  5. The foundation keeps shipping. npx acrylblends update merges new releases under your layer, and your changes stay.

Stop selling features. Sell a platform your customers finish themselves.

Five nouns: the whole model

Noun What it is
App A folder: blend.yaml, its plugins, its data. Copy the folder, copy the app.
Host One process per app. It loads plugins and swaps them while the app runs.
Plugin The only unit of capability: a page, a tool, a service.
Surface Web or Desktop. It draws what the Host serves and owns no logic.
Driver An agent working inside the app. The built-in chat is one of many.

Share and pull

  • Blends (whole apps): share your app to your own GitHub repository and list it in the store as Community (npm run share -- --visibility public --list). Anyone makes an app from it (npx acryl new their-app --from github:you/your-app#v0.1.0) and later brings in your next release with npx acrylblends update, keeping their own changes.
  • Cordis plugins (single capabilities): publish a plugin to your GitHub (npm run acryl -- plugin publish <name>) and pull anyone's into your app by its address (npm run acryl -- plugin pull github:owner/repo@version).
  • WebBoxes: deploy any Blend to your own hosted box at webboxes.ai, with its agents.

What is in this repository

The reusable building blocks of the platform: the framework (framework/: @acryldev/blends, @acryldev/create-blends, the frame), the runtime (runtime/), the plugins (plugins/) and the acryl command (distribution/acryl-npm-launcher). Products built on them live in their own Blend repositories: ACRYL Control Center, ACRYL ADE, ACRYL SDE. Framework documentation: framework/docs.

ACRYL builds on Cordis, the meta-framework of composable plugins, and on a pinned DeepSeek Harness checkout for its chat agent. ACRYL is not affiliated with, authorized by, or endorsed by DeepSeek.

Run from source

Requirements: Node.js ^22.19.0 or >=24.0.0, Corepack (selects the pinned PNPM 12.14.0).

corepack pnpm run upstream:sync
corepack pnpm install --frozen-lockfile
corepack pnpm run verify

Essentials:

  • corepack pnpm run verify - fast headless loop (typecheck + tests)
  • corepack pnpm run check - complete headless gate, use before handoff

Repository layout: framework/ (the Blends framework and its packages), runtime/ (the stable core), plugins/ (replaceable capability packages), distribution/ (the acryl command), deepseek-harness/ (pinned upstream submodule, never edited from a feature branch). scripts/verify-layout.mjs enforces it.

Project links

Contributing

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.

Contributors

Thanks to everyone building ACRYL - every report, idea, and PR counts:

musichen levonk kuishou68 smrifat1411

All contributors on GitHub.

Who did what, by name: CONTRIBUTORS.md (中文). Your name belongs here - see CONTRIBUTING.md.

License

ACRYL is licensed under the MIT License.

Acknowledgements

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.

About

ACRYL (Agent Context Relay Yielding Lifecycles) is a platform for agentic apps: build them with any coding agent inside, run them as desktop, web, cli-tui or deploy to cloud, share them as Blends. Every feature is a swappable plugin. Each app is a Blend of swappable plugins with coding agents built in.

Topics

Resources

Code of conduct

Contributing

Stars

276 stars

Watchers

8 watching

Forks

Releases

Packages

Used by

Contributors

Languages