# AGENTS.md

Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active

## Setup

```
bun install
```

## Commands

```
bun build           # produce a build
bun lint            # lint
bun format          # format
bun update
bun add-balance
bun set-balance
bun list-balances
bun user-stats
```

## Layout

- `client/`   1783 source files
- `packages/` 1637 source files
- `api/`      573 source files
- `e2e/`      124 source files
- `config/`   47 source files
- `otel/`     4 source files

## Conventions

- Tests live alongside the code they cover, following `api/app/clients/prompts/formatAgentMessages.spec.js`.
- CI defines what passing means. See `.github/workflows/a11y.yml`, and keep it green.
- TODO: add the two or three conventions a newcomer always gets wrong here.

## Gotchas

- `packages/api/src/stream/GenerationJobManager.ts` is 291KB. It will not fit comfortably in context, so read it in parts.
- Copy `.env.example` before running anything that needs configuration.

---

Drafted by agentreadme.com from what is in this repository. Everything marked TODO
needs a human. Check it in as AGENTS.md at the root.