Repo brief: twentyhq/twenty

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T11:38:56.826Z · commit c77378bb6a8c

Verdict

Healthy — Healthy across all four use cases

• Last commit today
• 16 active contributors
• Distributed ownership (top contributor 33% of recent commits)
• MIT licensed
• 2 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

Twenty is an open-source, AI-ready CRM alternative to Salesforce that lets technical teams define objects, fields, and views entirely as code and version them alongside their application stack. The core platform uses TypeScript monorepos to scaffold customizable CRM applications via create-twenty-app, generate type-safe SDK clients from GraphQL metadata, and deploy apps to a managed Twenty workspace. Monorepo managed by Yarn workspaces (packageManager: yarn@4.13.0): packages/create-twenty-app/ contains the scaffolding CLI and template constants; packages/twenty-client-sdk/ holds the GraphQL code generator and typed SDK client; packages/create-twenty-app/src/constants/template/…

Start here

Open these first:

• packages/create-twenty-app/src/cli.ts — Entry point for the create-twenty-app CLI tool; handles application scaffolding and initialization for new Twenty projects.
• packages/create-twenty-app/src/create-app.command.ts — Core command implementation that orchestrates app creation workflow, template loading, and dependency installation.
• packages/twenty-client-sdk/src/generate/generate-core-client.ts — Generates the core GraphQL client from schema; essential for SDK functionality and type safety.
• packages/twenty-client-sdk/src/generate/genql/main.ts — Main entry point for the embedded genql code-generation engine that produces typed GraphQL clients.
• packages/create-twenty-app/src/constants/template/package.json — Template package.json that defines dependencies and build scripts for generated Twenty applications.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Clone the repository, then from the monorepo root: yarn install (as specified in packageManager constraint). To scaffold a new Twenty app: npx create-twenty-app my-app (from the README). To develop locally in the mo…

Daily commands:

From the monorepo root: yarn install && yarn lint && yarn test (runs all workspaces). To develop the create-twenty-app CLI locally, use yarn workspace packages/create-twenty-app then invoke the CLI. The generated te…

…shortened for this brief.

Key cautions & unknowns

• The template package.json has twenty-sdk and twenty-client-sdk pinned to TO-BE-GENERATED, meaning scaffold output will fail unless the publish step resolves these versions to real published packages. The…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• License evidence

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.