@chatr-box/cli

Build AI-powered chat applications with multi-agent workflows and interactive widgets

What is Chatrbox?

Chatrbox helps you build production-ready AI chat applications with:

• Multi-agent workflows - Researcher → Writer → Reviewer patterns
• Interactive widgets - Dynamic UI components that respond to AI actions
• Tool connectors - Calendar, database, maps, and custom integrations
• Modern frameworks - Next.js, React + Vite, or Astro
• TypeScript monorepo - Fully typed with shared packages

Perfect for building AI assistants, customer support bots, content creation tools, and more.

Quick Start

npx @chatr-box/cli

Choose your framework, configure your project, and start building in minutes.

Framework Options

| Framework | Tech Stack | Best For | | --------------- | ------------------------------- | ----------------------- | | Next.js | App Router, Tailwind, SSR | Full-stack applications | | Chakra UI | Vite + React, Component library | Modern React apps | | Material UI | Vite + React, Material Design | Google design system | | Astro | Islands architecture | Content-heavy sites |

What You Get

Complete Project Structure

my-app/
├── apps/your-framework/     # Your chosen frontend
├── packages/
│   ├── core/               # Shared types & utilities
│   ├── widgets/            # UI components & examples
│   └── server/             # AI actions & connectors
└── Configuration files (TypeScript, Git, etc.)

Ready-to-Use Features

• Environment setup with OpenAI integration
• Widget system for dynamic UI components
• Action handlers for AI tool interactions
• Agent prompts for multi-step workflows
• Testing setup (Vitest + Playwright for React apps)

Example Widgets & Tools

• Contact forms, data tables, todo cards
• Calendar scheduling, maps integration
• Database queries, file uploads
• Custom action handlers

Getting Started

1. Create your project

   npx @chatr-box/cli
   cd my-chatrbox-app

2. Add your OpenAI key

   cp .env.example .env
   # Edit .env with OPENAI_API_KEY=sk-proj-...

3. Start developing

   pnpm dev

Available Commands

| Command | Description | | ---------------- | ------------------------ | | pnpm dev | Start development server | | pnpm build | Build for production | | pnpm test | Run tests (React apps) | | pnpm typecheck | TypeScript validation |

Requirements

• Node.js 18+
• PNPM 8+ (install: npm i -g pnpm)
• Git

Resources

• Documentation
• Widget Guide
• Architecture
• Community

Alternative Install Methods

# Using pnpm
pnpm dlx @chatr-box/cli

# Using yarn
yarn dlx @chatr-box/cli

# Global install
npm install -g @chatr-box/cli
chatrbox

MIT License • Bryan Shea • Repository