A2UI Ink renderer for terminal and CLI applications

[kokoro-ele]

Hi A2UI community,

I built a community-maintained A2UI renderer for Ink, allowing A2UI surfaces to run in terminal and CLI applications.

Links

• GitHub: https://github.com/kokoro-ele/a2ui-ink
• npm: https://www.npmjs.com/package/@evanyu/a2ui-ink

Demo

https://github.com/user-attachments/assets/67536928-780a-4473-be50-8ff505984521
https://github.com/user-attachments/assets/bf2ee749-e5f0-4715-b56a-e212a4273083

Current support

• A2UI v0.9 and v0.9.1
• All 18 Basic Catalog components
• Data binding and client-side functions through @a2ui/web_core
• Keyboard interaction using Tab, Enter, Space, and arrow keys
• Official example replay
• Interactive terminal example explorer
• A2A live demo and offline mock mode
• 47 smoke and utility tests

Media components such as Image, Video, and AudioPlayer currently render terminal-friendly placeholders.

Install

yarn add @evanyu/a2ui-ink @a2ui/web_core ink react

Basic usage

import {render} from 'ink';
import {MessageProcessor} from '@a2ui/web_core/v0_9';
import {A2uiSurface, basicCatalog} from '@evanyu/a2ui-ink/v0_9';

const processor = new MessageProcessor([basicCatalog], async action => {
  console.log(action);
});

processor.processMessages(messages);

const surface = [...processor.model.surfacesMap.values()][0];
if (surface) {
  render(<A2uiSurface surface={surface} />);
}

Try the examples

git clone https://github.com/kokoro-ele/a2ui-ink.git
cd a2ui-ink
yarn install
yarn explorer

This renderer is experimental and maintained independently from the A2UI team. Feedback, bug reports, and contributions are welcome.