A git submodule-based monorepo for the Recoup platform.
# Clone with submodules
git clone --recurse-submodules git@github.com:recoupable/mono.git
# Or if already cloned, initialize submodules
git submodule update --init --recursive| 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 |
This monorepo is designed for LLM-assisted development. Each submodule contains its own agent context files with project-specific instructions.
AGENTS.md(root): Monorepo-wide guidance, git workflow, cross-project architecture — source of truth for all AI agentsCLAUDE.md(root): Symlink toAGENTS.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)
- Start with context: Point your LLM to
AGENTS.md(orCLAUDE.md) at the root for overall guidance - Work in submodules: Each submodule is an independent git repo - cd into the relevant folder
- Branch workflow: Never push directly to
main. Use feature branches and PRs - Special branches:
apiandchathave atestbranch - PRs should targettest, notmain
chat (frontend) → api (backend) → Supabase (database)
↓
tasks (async jobs)
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