Recoup Monorepo

A git submodule-based monorepo for the Recoup platform.

Quick Start

# Clone with submodules
git clone --recurse-submodules git@github.com:recoupable/mono.git

# Or if already cloned, initialize submodules
git submodule update --init --recursive

Repository Structure

Submodule	Description	Tech Stack
chat	Main chat application	Next.js 16, React 19, Vercel AI SDK, Stagehand
api	API service with payment middleware	Next.js 16, x402-next, Supabase
tasks	Background job workers	Trigger.dev v4
docs	API documentation	Mintlify
database	Database migrations	Supabase CLI
remotion	Video generation	Remotion
bash	Interactive bash demo with AI agent	Next.js 16, React 19, just-bash, AI SDK
skills	AI agent skills monorepo	Markdown, Git submodules

Using This Repo with an LLM

This monorepo is designed for LLM-assisted development. Each submodule contains its own agent context files with project-specific instructions.

Key Files for LLM Context

• AGENTS.md (root): Monorepo-wide guidance, git workflow, cross-project architecture — source of truth for all AI agents
• CLAUDE.md (root): Symlink to AGENTS.md — so Claude automatically picks up the same instructions
• Each submodule's context files: Project-specific build commands, patterns, and conventions
• API Docs: https://developers.recoupable.com (LLM-readable)

Tips for LLM Sessions

1. Start with context: Point your LLM to AGENTS.md (or CLAUDE.md) at the root for overall guidance
2. Work in submodules: Each submodule is an independent git repo - cd into the relevant folder
3. Branch workflow: Never push directly to main. Use feature branches and PRs
4. Special branches: api and chat have a test branch - PRs should target test, not main

Data Flow

chat (frontend) → api (backend) → Supabase (database)
                       ↓
                 tasks (async jobs)

Build Commands

All projects use pnpm:

pnpm install   # Install dependencies
pnpm dev       # Start dev server
pnpm build     # Production build
pnpm lint      # Fix lint issues
pnpm format    # Run prettier

Links

• App: https://chat.recoupable.com
• API: https://recoup-api.vercel.app/api
• Docs: https://developers.recoupable.com
• Website: https://recoupable.com