perceptron

Terminal UI for generating and running Vercel Workflow DevKit flows from natural-language prompts.

Prerequisites

• Devbox (manages all tooling)
• OpenCode must be installed and available on your PATH — the TUI spawns an OpenCode agent server for AI-powered workflow steps

Quick Start

devbox run start

This drops you into a Devbox shell (installing Bun, and other dependencies via the init hook) and starts the TUI.

Running in a Specific Folder

The TUI operates on whatever directory it's launched from. To target a different project:

cd /path/to/your/project && devbox run -c /path/to/workflow-tui -- bun /path/to/workflow-tui/index.tsx

For example:

cd ~/projects/my-app && devbox run -c ~/src/workflow-tui -- bun ~/src/workflow-tui/index.tsx

Development

devbox shell          # enter the dev environment
bun run dev           # hot-reload mode
bun test              # run tests