skill
chatOS
AI chat platform — Turborepo monorepo with Next.js 16, AI SDK v6, Better Auth, Neon Postgres. Full-stack conversational AI.
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/broomva/chatOS itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
Skills do not use an MCP config. Follow the steps in the README below.
README
synced Oct 22, 2026chatOS
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.