coding-agent-template  by vercel-labs

AI coding agent platform automating repository tasks

Created 2 months ago
1,238 stars

Top 31.7% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

This project provides a template for building multi-agent AI coding platforms, leveraging Vercel Sandbox for secure code execution and Vercel AI Gateway for model routing and observability. It targets developers seeking to automate coding tasks, offering support for various AI coding agents like Claude Code and OpenAI Codex, and simplifying repository interaction through AI-generated Git branches. The primary benefit is an integrated, automated workflow for AI-assisted code development and management.

How It Works

The platform orchestrates AI-driven coding tasks through a multi-stage process. Upon task submission, details are persisted in a PostgreSQL database. A key feature is AI-generated Git branch names, created using AI SDK 5 and Vercel AI Gateway, which are descriptive, conflict-free (using a 6-character hash), and context-aware, with a fallback to timestamp-based names. Code execution occurs within isolated Vercel Sandboxes. The user's chosen AI agent (Claude Code, Codex CLI, Cursor CLI, or opencode) analyzes the prompt, makes code modifications, which are then committed to the AI-generated branch. Finally, the sandbox is cleaned up.

Quick Start & Requirements

  1. Clone & Install: git clone https://github.com/vercel-labs/coding-agent-template.git, cd coding-agent-template, pnpm install.
  2. Environment Variables: Set POSTGRES_URL, ANTHROPIC_API_KEY, GITHUB_TOKEN, VERCEL_TEAM_ID, VERCEL_PROJECT_ID, AI_GATEWAY_API_KEY. Optional: CURSOR_API_KEY, NPM_TOKEN.
  3. Database Setup: Run pnpm db:generate and pnpm db:push.
  4. Run: Execute pnpm dev.
  • Prerequisites: PostgreSQL database, API keys for Anthropic, GitHub, and Vercel AI Gateway. Vercel account and project are required for sandbox functionality.
  • Links: Vercel Sandbox documentation is mentioned but not directly linked.

Highlighted Details

  • Multi-Agent Support: Integrates with Claude Code, OpenAI Codex CLI, Cursor CLI, and opencode.
  • Vercel Ecosystem: Built upon Vercel Sandbox for secure, isolated execution and Vercel AI Gateway for AI model management.
  • AI-Generated Branch Names: Automatically creates descriptive, conflict-free Git branches using AI, with fallback mechanisms.
  • Tech Stack: Features Next.js 15, React 19, Tailwind CSS, shadcn/ui, PostgreSQL with Drizzle ORM, and AI SDK 5.

Maintenance & Community

The provided README does not contain specific details regarding maintainers, community channels (like Discord/Slack), or a public roadmap.

Licensing & Compatibility

The license type is not specified in the provided README content. This omission requires clarification for adoption decisions, especially concerning commercial use or integration with closed-source projects.

Limitations & Caveats

The project has a strong dependency on the Vercel ecosystem (Vercel Sandbox, AI Gateway, Vercel CLI tokens) and requires multiple third-party API keys for operation. The use of Next.js 15 and React 19 suggests the project may be utilizing pre-release or bleeding-edge framework versions, potentially impacting stability. The absence of a specified license is a significant adoption blocker.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
15
Issues (30d)
1
Star History
89 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.