# Project pack: Twenty @ c13b414

Facts about **Twenty** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> Twenty is an open-source CRM, an alternative to Salesforce and HubSpot. You track people, companies and deals, customise objects and fields, view data as tables or boards, and connect email and calendar. It is built with modern web tools and has an API and a way to build your own apps.

## Setup path (checked 2026-11-03)
- **Needs Docker.** Tell the person before any setup work; no light non-Docker route is documented upstream. Docker Desktop on Windows may need a computer restart and an admin-only Windows feature (virtualisation); say so and let the person decide.
- Hosted alternative, **the person's choice, never a default**: Twenty Cloud (https://twenty.com); cost/account: official hosted service; account and price not verified here.
- Verdict source: https://raw.githubusercontent.com/twentyhq/twenty/HEAD/README.md
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/twentyhq/twenty
- Pinned commit: `c13b414b7a5a8a0a9c4f967be40bfa2c5a3a175e`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/twentyhq/twenty/archive/c13b414b7a5a8a0a9c4f967be40bfa2c5a3a175e.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://docs.twenty.com
- Licence: **AGPL-3.0-only**. Free to use and change. If other people use your changed version, including over a network (for example a website you host for them), you must offer them your source code under the same licence. Using it privately for yourself or your household has no extra obligations. Files marked Enterprise are under a commercial licence, and some packages are MIT. Check each file's header before reusing it.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/twentyhq/twenty bespoke-twenty
  cd bespoke-twenty
  git checkout --detach c13b414b7a5a8a0a9c4f967be40bfa2c5a3a175e
  # Prepare development requirements and local configuration first.
  corepack enable
  yarn install
  npx nx database:reset twenty-server
  yarn start
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  Follow the self-hosting guide at https://docs.twenty.com/developers/self-host/self-host, which provides a Docker Compose file.
  ```
- Tools these commands use: Docker with 4 GB or more of memory; Node 24 and Yarn 4 for development
- Develop: `yarn start`
- Test: `npx nx test twenty-server`
- Check/lint: `npx nx lint:diff-with-main twenty-server`
- Stack: typescript (React, NestJS, GraphQL, TypeORM, Nx, Yarn 4). Difficulty for a non-developer with an AI: **advanced**. A large Nx monorepo. The product is designed for customisation inside the app: objects, fields, views and apps. Changing the core needs the full toolchain and plenty of memory.
- The project's own AI instructions, in the repository: `AGENTS.md`, `CLAUDE.md`.
Personal data: **yes**. Stored in: A Postgres database plus a files store. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/twenty/c13b414/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/twenty/c13b414/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/twenty/c13b414/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/twenty/c13b414/r3/SKILL.md)