{"id":50761917,"url":"https://github.com/yashdev9274/supercli","last_synced_at":"2026-06-11T11:00:28.697Z","repository":{"id":332353358,"uuid":"1127691629","full_name":"yashdev9274/supercli","owner":"yashdev9274","description":"The open source AI coding agent","archived":false,"fork":false,"pushed_at":"2026-06-09T07:12:01.000Z","size":11804,"stargazers_count":3,"open_issues_count":11,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-09T09:13:20.360Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://supercli.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yashdev9274.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-04T12:08:10.000Z","updated_at":"2026-06-09T07:12:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/yashdev9274/supercli","commit_stats":null,"previous_names":["yashdev9274/supercli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/yashdev9274/supercli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashdev9274%2Fsupercli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashdev9274%2Fsupercli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashdev9274%2Fsupercli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashdev9274%2Fsupercli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yashdev9274","download_url":"https://codeload.github.com/yashdev9274/supercli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashdev9274%2Fsupercli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34195117,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-11T11:00:19.856Z","updated_at":"2026-06-11T11:00:28.675Z","avatar_url":"https://github.com/yashdev9274.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \n  # Supercode\n  \n  **AI-Powered Terminal Coding Agent**\n  \n  A monorepo containing the Supercode dashboard, documentation, terminal AI client, and shared packages.\n  \n  [![Website](https://img.shields.io/badge/Website-supercli.vercel.app-blue)](https://supercli.vercel.app)\n  [![Built with Bun](https://img.shields.io/badge/Runtime-Bun-black)](https://bun.sh)\n  [![Turborepo](https://img.shields.io/badge/Built%20with-Turborepo-EF4444)](https://turbo.build)\n  [![TypeScript](https://img.shields.io/badge/TypeScript-5.0-3178C6)](https://www.typescriptlang.org/)\n\n  \u003cimg src=\"./apps/web/public/og-image.png\" alt=\"Supercode Platform\" width=\"800\"/\u003e\n\n\u003c/div\u003e\n\n---\n\n## Overview\n\nSupercode is a full-stack AI-powered development platform built as a monorepo using Turborepo. It provides:\n\n- **Dashboard** - Web interface for managing repositories, viewing analytics, and GitHub OAuth integration\n- **Documentation** - MDX-based documentation site\n- **Terminal Client** - AI-powered terminal coding assistant (in development)\n- **Video Generation** - Remotion-based video creation tools\n- **Open Model** - Fine-tuning open-source LLMs (Qwen3, GLM-4) for coding tasks\n\n## Architecture\n\nThis is a **monorepo** managed with [Turborepo](https://turbo.build), containing multiple applications and shared packages.\n\n### Applications\n\n| App | Description | Port |\n|-----|-------------|------|\n| `apps/web` | Next.js dashboard application | 3000 |\n| `apps/docs` | MDX documentation site | 3001 |\n| `apps/supercode-cli/client` | Terminal AI web client | TBD |\n| `apps/supercode-cli/server` | Terminal WebSocket server | TBD |\n| `apps/api` | API server (scaffolded) | TBD |\n| `apps/video` | Remotion video generation | - |\n\n### Packages\n\n| Package | Description |\n|---------|-------------|\n| `@super/db` | Prisma database client and schema |\n| `@super/auth` | Better-Auth configuration (server \u0026 client) |\n| `@super/ui` | Shared UI components |\n| `@super/sdk` | SDK package |\n| `@super/config` | Shared configuration |\n| `@super/dashboard` | Dashboard components |\n\n## Supercode Open Model 🧠\n\nWe're building a **coding-focused LLM** by fine-tuning open-source models for the Supercode Terminal. This project runs in parallel with the main platform.\n\n### Goal\n\nFine-tune open models to create an AI assistant specialized in:\n- Code generation and completion\n- Debugging and error fixing\n- Code explanation and documentation\n- Multi-language programming support\n\n### Training Strategy\n\nWe're using a **dual-track approach** to train two models simultaneously:\n\n| Track | Infrastructure | Model | Method | Estimated Cost |\n|-------|---------------|-------|--------|----------------|\n| **Track 1** | [Tinker](https://thinkingmachines.ai/tinker/) (Managed) | Qwen3-8B | LoRA | $150 free credits |\n| **Track 2** | [Modal](https://modal.com) + Axolotl | GLM-4-9B | LoRA/QLoRA | ~$15-20 |\n\n### Training Pipeline\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│                  PARALLEL TRAINING TRACKS                       │\n├─────────────────────────────────────────────────────────────────┤\n│                                                                 │\n│  Track 1: Tinker + Qwen3        Track 2: Modal + GLM-4         │\n│                                                                 │\n│  Setup → Dataset → Fine-tune → Evaluate → Compare → Deploy     │\n│                                                                 │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n### Project Structure\n\n```\nsupercode-openmodel/\n├── training/\n│   ├── data/                    # Dataset preparation scripts\n│   ├── tinker_qwen3/            # Tinker + Qwen3 training code\n│   └── evaluation/              # Model evaluation scripts\n├── models/                      # Model checkpoints\n├── config/                      # Training configurations\n└── supercode-openmodel.md       # Detailed training guide\n```\n\n### Training Datasets\n\nWe use high-quality coding datasets:\n\n| Dataset | Size | Purpose |\n|---------|------|---------|\n| [CodeAlpaca](https://huggingface.co/datasets/HuggingFaceH4/CodeAlpaca_20K) | 20K | Instruction tuning |\n| [OpenCodeReasoning](https://huggingface.co/datasets/nvidia/OpenCodeReasoning) | 100K+ | Reasoning + coding |\n| [CodeFeedback](https://huggingface.co/datasets/m-a-p/CodeFeedback-Filtered-Instruction) | 156K | Instruction-response |\n\n### Quick Start\n\n1. **Set up Tinker (Track 1)**\n   ```bash\n   pip install tinker\n   export TINKER_API_KEY=\"your-key\"\n   cd supercode-openmodel/training/tinker_qwen3\n   python train.py\n   ```\n\n2. **Set up Modal (Track 2)**\n   ```bash\n   pip install modal\n   modal token new\n   # Configure HuggingFace token in Modal secrets\n   modal run --detach src.train --config=config/glm4.yml\n   ```\n\n### Documentation\n\nFor detailed setup instructions, dataset preparation, and evaluation metrics, see:\n- **[supercode-openmodel.md](./supercode-openmodel.md)** - Complete training guide with code examples\n\n### Current Status\n\n🚧 **In Progress** - Actively training and evaluating models. The best-performing model will be deployed to the Supercode Terminal app.\n\n---\n\n## Tech Stack\n\n### Framework \u0026 Runtime\n- **Next.js 16** - React framework with App Router\n- **React 19** - UI library\n- **TypeScript 5** - Type safety\n- **Bun** - JavaScript runtime \u0026 package manager\n\n### Monorepo\n- **Turborepo** - Build system for monorepos\n\n### Database \u0026 ORM\n- **PostgreSQL** - Primary database\n- **Prisma 7** - Database ORM\n- **Pinecone** - Vector database\n\n### Authentication\n- **Better Auth** - Authentication system\n- **GitHub OAuth** - Social login\n\n### UI \u0026 Styling\n- **Tailwind CSS v4** - Utility-first CSS\n- **Radix UI** - Component primitives\n- **Framer Motion** - Animations\n- **Lucide Icons** - Icon library\n\n### State \u0026 Data\n- **TanStack Query** - Server state management\n- **React Hook Form** - Form handling\n- **Zod** - Schema validation\n\n### AI \u0026 ML\n- **Google Gemini** - AI model (embeddings)\n- **AI SDK** - AI integration\n\n## Getting Started\n\n### Prerequisites\n\n- **Bun** 1.2+ ([Install](https://bun.sh))\n- **PostgreSQL** database ([Neon](https://neon.tech), [Supabase](https://supabase.com), or local)\n- **Git**\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/yashdev9274/supercli.git\n   cd supercli\n   ```\n\n2. **Install dependencies**\n   ```bash\n   bun install\n   ```\n\n3. **Set up environment variables**\n   ```bash\n   cp .env.example .env\n   ```\n   \n   Edit `.env` with your configuration. Required variables:\n   ```env\n   DATABASE_URL=\"postgresql://...\"\n   BETTER_AUTH_SECRET=\"your-secret-key\"\n   BETTER_AUTH_URL=\"http://localhost:3000\"\n   GITHUB_CLIENT_ID=\"your-github-oauth-id\"\n   GITHUB_CLIENT_SECRET=\"your-github-oauth-secret\"\n   ```\n\n4. **Set up the database**\n   ```bash\n   cd packages/db\n   bunx prisma migrate dev\n   bun run db:generate\n   cd ../..\n   ```\n\n5. **Start development servers**\n   ```bash\n   # Start all apps\n   bun run dev\n   \n   # Or start specific apps\n   bun run dev:web      # Dashboard on port 3000\n   bun run dev:docs     # Docs on port 3001\n   bun run dev:terminal # Terminal client\n   ```\n\n6. **Open your browser**\n   - Dashboard: [http://localhost:3000](http://localhost:3000)\n   - Documentation: [http://localhost:3001](http://localhost:3001)\n\n### GitHub OAuth Setup\n\n1. Go to [GitHub Developer Settings](https://github.com/settings/developers)\n2. Create a new OAuth App\n3. Set Authorization callback URL: `http://localhost:3000/api/auth/callback/github`\n4. Copy Client ID and Client Secret to your `.env` file\n\n## Project Structure\n\n```\nsupercli/\n├── apps/\n│   ├── web/                 # Dashboard application\n│   │   ├── app/             # Next.js App Router\n│   │   │   ├── (auth)/      # Auth pages\n│   │   │   ├── dashboard/   # Dashboard pages\n│   │   │   └── api/         # API routes\n│   │   ├── components/      # React components\n│   │   ├── lib/             # Utilities\n│   │   └── modules/         # Feature modules\n│   │\n│   ├── docs/                # Documentation site\n│   │   ├── app/             # Next.js App Router\n│   │   └── content/         # MDX content\n│   │\n│   ├── supercode-cli/       # Terminal AI app\n│   │   ├── client/          # Web client\n│   │   └── server/          # WebSocket server\n│   │\n│   ├── api/                 # API server\n│   └── video/               # Video generation #optional\n│\n├── packages/\n│   ├── db/                  # Prisma client\n│   │   └── prisma/\n│   │       └── schema.prisma\n│   │\n│   ├── auth/                # Better-Auth config\n│   │   ├── server.ts\n│   │   └── client.ts\n│   │\n│   ├── ui/                  # Shared UI\n│   ├── sdk/                 # SDK\n│   ├── config/              # Config\n│   └── dashboard/           # Dashboard components\n│\n├── supercode-openmodel/     # LLM fine-tuning project\n│   ├── training/            # Training scripts\n│   ├── models/              # Model checkpoints\n│   ├── config/              # Training configs\n│   └── supercode-openmodel.md  # Training guide\n│\n├── turbo.json               # Turborepo config\n├── package.json             # Root package\n├── .env.example             # Environment template\n├── CONTRIBUTING.md          # Contribution guide\n└── README.md                # This file\n```\n\n## Available Scripts\n\n### Development\n\n```bash\nbun run dev              # Start all apps\nbun run dev:web          # Dashboard only (port 3000)\nbun run dev:docs         # Docs only (port 3001)\nbun run dev:terminal     # Terminal client only\nbun run dev:api          # API server only\n```\n\n### Build \u0026 Quality\n\n```bash\nbun run build            # Build all apps and packages\nbun run lint             # Run ESLint across all packages\nbun run typecheck        # Run TypeScript checks\n```\n\n### Database\n\n```bash\ncd packages/db\nbun run db:generate      # Generate Prisma client\nbun run db:migrate       # Deploy migrations\nbunx prisma studio       # Open Prisma Studio\nbunx prisma migrate dev --name migration_name  # Create migration\n```\n\n### Video Generation\n\n```bash\nbun run dev:video        # Start Remotion studio\nbun run build:video      # Build video\nbun run build:video:square    # Square format\nbun run build:video:vertical  # Vertical format\n```\n\n## Environment Variables\n\nSee `.env.example` for all available environment variables.\n\n### Required\n\n| Variable | Description |\n|----------|-------------|\n| `DATABASE_URL` | PostgreSQL connection string |\n| `BETTER_AUTH_SECRET` | Session encryption secret |\n| `BETTER_AUTH_URL` | Base URL (http://localhost:3000) |\n| `GITHUB_CLIENT_ID` | GitHub OAuth app client ID |\n| `GITHUB_CLIENT_SECRET` | GitHub OAuth app secret |\n\n### Optional\n\n| Variable | Description |\n|----------|-------------|\n| `GOOGLE_GEMINI_API_KEY` | Google Gemini AI API key |\n| `PINECONE_DB_API_KEY` | Pinecone vector database key |\n| `HUGGING_FACE_TOKEN` | Hugging Face API token |\n| `TINKER_API_KEY` | Tinker API key for LLM fine-tuning |\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details on:\n\n- Development setup\n- Code style guidelines\n- Commit conventions\n- Pull request process\n\n## License\n\nThis project is currently private and proprietary.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cstrong\u003eBuilt with ❤️ by the Supercode team!\u003c/strong\u003e\n\u003c/div\u003e\n\n\n\u003c!-- comment for testing 1 --\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashdev9274%2Fsupercli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyashdev9274%2Fsupercli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashdev9274%2Fsupercli/lists"}