chatOS

A best-in-class AI chatbot monorepo template with streaming, multi-model support, and multi-platform bots.

Built with Turborepo, Next.js 16, Vercel AI SDK, Better Auth, Drizzle ORM, and Chat SDK.

Features

• Multi-model AI chat — Claude, GPT, Gemini, Grok via Vercel AI Gateway
• Streaming — Real-time responses with resumable streams (Redis-backed)
• Tool calling — Extensible tool system (weather, documents, web search)
• Multi-platform bots — Slack, Teams, Discord via Chat SDK
• Type-safe — End-to-end with tRPC, Drizzle, Zod
• Agent-native — Control metalayer, harness engineering, skills for AI-assisted development
• Monorepo — Turborepo with caching, shared packages, parallel builds

Quick Start

# Clone
git clone https://github.com/broomva/chatOS.git
cd chatOS

# Install
bun install

# Configure
cp env.example .env.local
# Fill in DATABASE_URL, AUTH_SECRET, AI_GATEWAY_API_KEY

# Develop
turbo dev

Apps start on:

• Web chatbot: http://localhost:3000
• Bot service: http://localhost:3001
• Documentation: http://localhost:3002

Architecture

chatOS/
├── apps/
│   ├── web/          Next.js AI chatbot
│   ├── bot/          Chat SDK multi-platform bot
│   └── docs/         Fumadocs documentation
├── packages/
│   ├── ai/           AI SDK models, tools, streaming
│   ├── auth/         Better Auth configuration
│   ├── config/       Shared tsconfig, tailwind presets
│   ├── db/           Drizzle schema, queries, migrations
│   ├── types/        Shared TypeScript types
│   └── ui/           shadcn/ui shared components
├── .control/         Agent governance (policy, commands, topology)
├── docs/control/     Architecture, observability, control loop
├── scripts/control/  Deterministic command wrappers
├── skills/           Project-local agent skills
└── evals/            Control metrics

Commands

Command	Description
bun install	Install all dependencies
turbo dev	Start all apps in development
turbo build	Build all packages and apps
make smoke	Environment + build sanity check
make check	Lint (Biome) + typecheck
make test	Full test suite
make control-audit	Validate agent governance artifacts

Tech Stack

Layer	Technology
Monorepo	Turborepo + Bun
Framework	Next.js 16 (App Router)
AI	Vercel AI SDK + AI Gateway
Auth	Better Auth
Database	PostgreSQL + Drizzle ORM
Cache	Redis (Upstash)
UI	shadcn/ui + Radix + Tailwind v4
Bot	Chat SDK (Slack, Teams, Discord)
Lint	Biome
Test	Vitest + Playwright
Docs	Fumadocs
CI/CD	GitHub Actions

Agent-Native Development

This repo is designed for AI-assisted development with:

• AGENTS.md — Command surface and rules for AI agents
• PLANS.md — Durable planning for multi-step tasks
• METALAYER.md — Control-loop setpoints and feedback
• CLAUDE.md — Project context for Claude Code
• .control/ — Policy, commands, topology YAML
• skills/ — Project-local skills for development guidance
• Makefile.control — Deterministic gate commands (smoke → check → test)

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT