Prerequisites: Git, Bun 1.2+, Docker Desktop (for local DB)

<div align="center">

  # Supercode

  **AI-Powered SWE Agent**

  A monorepo containing the Supercode dashboard, documentation, terminal web client, CLI coding agent, and shared packages.

  [![Website](https://img.shields.io/badge/Website-supercli.com-blue)](https://supercli.vercel.app)
  [![Built with Bun](https://img.shields.io/badge/Runtime-Bun-black)](https://bun.sh)
  [![Turborepo](https://img.shields.io/badge/Built%20with-Turborepo-EF4444)](https://turbo.build)
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.0-3178C6)](https://www.typescriptlang.org/)
  [![Next.js](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org)
  [![License](https://img.shields.io/badge/License-MIT-green)](./LICENSE)
  [![CI](https://github.com/yashdev9274/supercli/actions/workflows/ci.yml/badge.svg)](https://github.com/yashdev9274/supercli/actions/workflows/ci.yml)
  [![npm](https://img.shields.io/npm/v/supercode?label=supercode)](https://www.npmjs.com/package/supercode)
  [![GitHub stars](https://img.shields.io/github/stars/yashdev9274/supercli?style=social)](https://github.com/yashdev9274/supercli)

  <img src="./apps/web/public/og-image.png" alt="Supercode Platform" width="800"/>

</div>

---

## Star History

<a href="https://www.star-history.com/?repos=yashdev9274%2Fsupercli&type=date&legend=bottom-right">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=yashdev9274/supercli&type=date&theme=dark&legend=top-left" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=yashdev9274/supercli&type=date&legend=top-left" />
   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=yashdev9274/supercli&type=date&legend=top-left" />
 </picture>
</a>

---

## Quick Start

```bash
# Prerequisites: Git, Bun 1.2+, Docker Desktop (for local DB)
git clone https://github.com/yashdev9274/supercli.git
cd supercli
bun install                        # install dependencies
cp apps/web/.env.example apps/web/.env.local  # configure env
docker compose up -d               # start PostgreSQL
bun run db:migrate                 # create database tables
bun run dev:web                    # start the dashboard
```

> **Dashboard** → http://localhost:3000

No database? Set one up later — `bun install` skips Prisma client generation gracefully when `DATABASE_URL` isn't set.

---

## Overview

Supercode is a full-stack AI-powered development platform built as a Bun + Turborepo monorepo. It includes a web dashboard, an MDX documentation site, an AI coding agent CLI, a terminal-style web client, and a parallel project for fine-tuning open-source LLMs.

- **Dashboard** (`apps/web`) — Next.js dashboard for managing repositories, viewing analytics, and GitHub OAuth
- **Documentation** (`apps/docs`) — MDX-based documentation site
- **Terminal Web Client** (`apps/supercode-cli/client`) — Browser UI that mirrors the CLI experience
- **Supercode CLI** (`apps/supercode-cli/server`) — AI-powered coding agent published to npm as `supercode`
- **API Server** (`apps/api`) — Scaffolding for a shared backend
- **Open Model** (`supercode-openmodel/`) — Fine-tuning open-source LLMs (Qwen3, GLM-4) for coding tasks

## Architecture

This is a **monorepo** managed with [Turborepo](https://turbo.build) and [Bun](https://bun.sh) workspaces. Workspaces are defined in `package.json` as `apps/*`, `apps/supercode-cli/*`, and `packages/*`.

### Applications

| App | Description | Port |
|-----|-------------|------|
| `apps/web` | Next.js 16 dashboard (supercli.com) | `3000` |
| `apps/docs` | Next.js MDX documentation site | `3001` |
| `apps/supercode-cli/client` | Terminal web client UI (Next.js) | `3002` |
| `apps/supercode-cli/server` | AI coding agent — also published as the `supercode` npm CLI | — |
| `apps/api` | Shared API server (scaffolded) | TBD |


### Packages

| Package | Description |
|---------|-------------|
| `@super/db` | Prisma client + schema for the dashboard database |
| `@super/auth` | Better-Auth configuration (server + client) |
| `@super/ui` | Shared UI components |
| `@super/sdk` | Internal SDK |
| `@super/config` | Shared configuration (ESLint, TS, etc.) |
| `@super/dashboard` | Dashboard-specific component library |
| `@super/db-terminal` | Prisma client + schema for the terminal CLI's separate database |
| `@super/claude-sdk` | Claude / Anthropic AI SDK wrapper |
| `@super/embeddings-sdk` | Embeddings provider SDK (Gemini, etc.) |
| `@super/skills` | Reusable AI agent skills shared across apps |

## Terminal Stack 🖥️

The `apps/supercode-cli` workspace contains two sub-apps that together form the Supercode terminal product:

```
apps/supercode-cli/
├── client/   # Next.js 16 web client — terminal.supercli.com
└── server/   # Bun-powered AI coding agent, exposed as the `supercode` CLI
```

- **Client** is a Next.js app that mirrors the terminal experience in the browser, intended to be deployed to `termi

... (truncated)