{
  "markdown": "<p align=\"center\">\n  <a href=\"https://www.twenty.com\">\n    <img src=\"./packages/twenty-website/public/images/core/logo.svg\" width=\"100px\" alt=\"Twenty logo\" />\n  </a>\n</p>\n\n<h2 align=\"center\">The #1 Open-Source CRM</h2>\n\n<p align=\"center\"><a href=\"https://twenty.com\"><img src=\"./packages/twenty-website/public/images/readme/globe-icon.svg\" width=\"12\" height=\"12\"/> Website</a> · <a href=\"https://docs.twenty.com\"><img src=\"./packages/twenty-website/public/images/readme/book-icon.svg\" width=\"12\" height=\"12\"/> Documentation</a> · <a href=\"https://github.com/orgs/twentyhq/projects/1\"><img src=\"./packages/twenty-website/public/images/readme/map-icon.svg\" width=\"12\" height=\"12\"/> Roadmap </a> · <a href=\"https://discord.gg/cx5n4Jzs57\"><img src=\"./packages/twenty-website/public/images/readme/discord-icon.svg\" width=\"12\" height=\"12\"/> Discord</a> · <a href=\"https://www.figma.com/file/xt8O9mFeLl46C5InWwoMrN/Twenty\"><img src=\"./packages/twenty-website/public/images/readme/figma-icon.webp\"  width=\"12\" height=\"12\"/>  Figma</a></p>\n\n<p align=\"center\">\n  <a href=\"https://www.twenty.com\">\n    <picture>\n      <source media=\"(prefers-color-scheme: dark)\" srcset=\"./packages/twenty-website/public/images/readme/github-cover-dark.webp\" />\n      <source media=\"(prefers-color-scheme: light)\" srcset=\"./packages/twenty-website/public/images/readme/github-cover-light.webp\" />\n      <img src=\"./packages/twenty-website/public/images/readme/github-cover-light.webp\" alt=\"Twenty banner\" />\n    </picture>\n  </a>\n</p>\n\n<br />\n\n# Why Twenty\n\nTwenty gives technical teams the building blocks for a custom CRM that meets complex business needs and quickly adapts as the business evolves. Twenty is the CRM you build, ship, and version like the rest of your stack.\n\n<a href=\"https://twenty.com/resources/why-twenty\"><img src=\"./packages/twenty-website/public/images/readme/star-icon.svg\" width=\"14\" height=\"14\"/> Learn more about why we built Twenty</a>\n\n<br />\n\n# Installation\n\n### <img src=\"./packages/twenty-website/public/images/readme/globe-icon.svg\" width=\"14\" height=\"14\"/> Cloud\n\nThe fastest way to get started. Sign up at [twenty.com](https://twenty.com) and spin up a workspace in under a minute, with no infrastructure to manage and always up to date.\n\n### <img src=\"./packages/twenty-website/public/images/readme/book-icon.svg\" width=\"14\" height=\"14\"/> Build an app\n\nScaffold a new app with the Twenty CLI:\n\n```bash\nnpx create-twenty-app my-app\n```\n\nDefine objects, fields, and views as code:\n\n```ts\nimport { defineObject, FieldType } from 'twenty-sdk/define';\n\nexport default defineObject({\n  nameSingular: 'deal',\n  namePlural: 'deals',\n  labelSingular: 'Deal',\n  labelPlural: 'Deals',\n  fields: [\n    { name: 'name', label: 'Name', type: FieldType.TEXT },\n    { name: 'amount', label: 'Amount', type: FieldType.CURRENCY },\n    { name: 'closeDate', label: 'Close Date', type: FieldType.DATE_TIME },\n  ],\n});\n```\n\nThen ship it to your workspace:\n\n```bash\nnpx twenty app:publish --private\n```\n\nSee the [app development guide](https://docs.twenty.com/developers/extend/apps/getting-started) for objects, views, agents, and logic functions.\n\nBuilding with a coding agent? Install the official [Twenty app skills](./packages/twenty-agent-skills), which work in Claude Code, Codex, Cursor, Pi, and any other harness supported by the `skills` CLI:\n\n```bash\nnpx skills add https://github.com/twentyhq/twenty/tree/agent-skills --list\n```\n\nThe `agent-skills` branch is created by the first successful publish from `main`. Until then, use the [local build instructions](./packages/twenty-agent-skills#local-development). [`SKILLS.md`](./SKILLS.md) explains the other skill families in this repository and who they are for.\n\n### <img src=\"./packages/twenty-website/public/images/readme/rocket-icon.svg\" width=\"14\" height=\"14\"/> Self-hosting\n\nRun Twenty on your own infrastructure with [Docker Compose](https://docs.twenty.com/developers/self-host/capabilities/docker-compose), or contribute locally via the [local setup guide](https://docs.twenty.com/developers/contribute/capabilities/local-setup).\n\n<br />\n<br />\n\n# Everything you need\n\nTwenty gives you the building blocks of a modern CRM (objects, views, workflows, and agents) and lets you extend them as code. Here's a tour of what's in the box.\n\nWant to go deeper? Read the <a href=\"https://docs.twenty.com/user-guide/introduction\"><img src=\"./packages/twenty-website/public/images/readme/planner-icon.svg\" width=\"14\" height=\"14\"/> User Guide</a> for product walkthroughs, or the <a href=\"https://docs.twenty.com\"><img src=\"./packages/twenty-website/public/images/readme/book-icon.svg\" width=\"14\" height=\"14\"/> Documentation</a> for developer reference.\n\n<table align=\"center\">\n  <tr>\n    <td width=\"50%\">\n      <picture>\n        <source media=\"(prefers-color-scheme: dark)\" srcset=\"./packages/twenty-website/public/images/readme/v2-build-apps-dark.webp\" />\n        <source media=\"(prefers-color-scheme: light)\" srcset=\"./packages/twenty-website/public/images/readme/v2-build-apps-light.webp\" />\n        <img src=\"./packages/twenty-website/public/images/readme/v2-build-apps-light.webp\" alt=\"Create your apps\" />\n      </picture>\n      <p align=\"center\"><a href=\"https://docs.twenty.com/developers/extend/apps/getting-started\"><img src=\"./packages/twenty-website/public/images/readme/code-icon.svg\" width=\"16\" height=\"16\"/> Learn more about apps in doc</a></p>\n    </td>\n    <td width=\"50%\">\n      <picture>\n        <source media=\"(prefers-color-scheme: dark)\" srcset=\"./packages/twenty-website/public/images/readme/v2-version-control-dark.webp\" />\n        <source media=\"(prefers-color-scheme: light)\" srcset=\"./packages/twenty-website/public/images/readme/v2-version-control-light.webp\" />\n        <img src=\"./packages/twenty-website/public/images/readme/v2-version-control-light.webp\" alt=\"Stay on top with version control\" />\n      </picture>\n      <p align=\"center\"><a href=\"https://docs.twenty.com/developers/extend/apps/publishing\"><img src=\"./packages/twenty-website/public/images/readme/monitor-icon.svg\" width=\"16\" height=\"16\"/> Learn more about version control in doc</a></p>\n    </td>\n  </tr>\n  <tr>\n    <td width=\"50%\">\n      <picture>\n        <source media=\"(prefers-color-scheme: dark)\" srcset=\"./packages/twenty-website/public/images/readme/v2-all-tools-dark.webp\" />\n        <source media=\"(prefers-color-scheme: light)\" srcset=\"./packages/twenty-website/public/images/readme/v2-all-tools-light.webp\" />\n        <img src=\"./packages/twenty-website/public/images/readme/v2-all-tools-light.webp\" alt=\"All the tools you need to build anything\" />\n      </picture>\n      <p align=\"center\"><a href=\"https://docs.twenty.com/developers/extend/apps/building\"><img src=\"./packages/twenty-website/public/images/readme/rocket-icon.svg\" width=\"16\" height=\"16\"/> Learn more about primitives in doc</a></p>\n    </td>\n    <td width=\"50%\">\n      <picture>\n        <source media=\"(prefers-color-scheme: dark)\" srcset=\"./packages/twenty-website/public/images/readme/v2-tools-dark.webp\" />\n        <source media=\"(prefers-color-scheme: light)\" srcset=\"./packages/twenty-website/public/images/readme/v2-tools-light.webp\" />\n        <img src=\"./packages/twenty-website/public/images/readme/v2-tools-light.webp\" alt=\"Customize your layouts\" />\n      </picture>\n      <p align=\"center\"><a href=\"https://docs.twenty.com/user-guide/layout/overview\"><img src=\"./packages/twenty-website/public/images/readme/planner-icon.svg\" width=\"16\" height=\"16\"/> Learn more about layouts in doc</a></p>\n    </td>\n  </tr>\n  <tr>\n    <td width=\"50%\">\n      <picture>\n        <source media=\"(prefers-color-scheme: dark)\" srcset=\"./packages/twenty-website/public/images/readme/v2-ai-agents-dark.webp\" />\n        <source media=\"(prefers-color-scheme: light)\" srcset=\"./packages/twenty-website/public/images/readme/v2-ai-agents-light.webp\" />\n        <img src=\"./packages/twenty-website/public/images/readme/v2-ai-agents-light.webp\" alt=\"AI agents and chats\" />\n      </picture>\n      <p align=\"center\"><a href=\"https://docs.twenty.com/user-guide/ai/overview\"><img src=\"./packages/twenty-website/public/images/readme/message-icon.svg\" width=\"16\" height=\"16\"/> Learn more about AI in doc</a></p>\n    </td>\n    <td width=\"50%\">\n      <picture>\n        <source media=\"(prefers-color-scheme: dark)\" srcset=\"./packages/twenty-website/public/images/readme/v2-crm-tools-dark.webp\" />\n        <source media=\"(prefers-color-scheme: light)\" srcset=\"./packages/twenty-website/public/images/readme/v2-crm-tools-light.webp\" />\n        <img src=\"./packages/twenty-website/public/images/readme/v2-crm-tools-light.webp\" alt=\"Plus all the tools of a good CRM\" />\n      </picture>\n      <p align=\"center\"><a href=\"https://docs.twenty.com/user-guide/introduction\"><img src=\"./packages/twenty-website/public/images/readme/star-icon.svg\" width=\"16\" height=\"16\"/> Learn more about CRM features in doc</a></p>\n    </td>\n  </tr>\n</table>\n\n<br />\n\n# Stack\n\n- <a href=\"https://www.typescriptlang.org/\"><img src=\"./packages/twenty-website/public/images/readme/stack-typescript.svg\" width=\"14\" height=\"14\"/> TypeScript</a>\n- <a href=\"https://nx.dev/\"><img src=\"./packages/twenty-website/public/images/readme/stack-nx.svg\" width=\"14\" height=\"14\"/> Nx</a>\n- <a href=\"https://nestjs.com/\"><img src=\"./packages/twenty-website/public/images/readme/stack-nestjs.svg\" width=\"14\" height=\"14\"/> NestJS</a>, with <a href=\"https://bullmq.io/\">BullMQ</a>, <a href=\"https://www.postgresql.org/\"><img src=\"./packages/twenty-website/public/images/readme/stack-postgresql.svg\" width=\"14\" height=\"14\"/> PostgreSQL</a>, <a href=\"https://redis.io/\"><img src=\"./packages/twenty-website/public/images/readme/stack-redis.svg\" width=\"14\" height=\"14\"/> Redis</a>\n- <a href=\"https://reactjs.org/\"><img src=\"./packages/twenty-website/public/images/readme/stack-react.svg\" width=\"14\" height=\"14\"/> React</a>, with <a href=\"https://jotai.org/\">Jotai</a>, <a href=\"https://linaria.dev/\">Linaria</a> and <a href=\"https://lingui.dev/\">Lingui</a>\n\n# Thanks\n\n<p align=\"center\">\n  <a href=\"https://greptile.com\"><img src=\"./packages/twenty-website/public/images/readme/greptile.webp\" height=\"28\" alt=\"Greptile\" /></a>\n  &nbsp;&nbsp;&nbsp;&nbsp;\n  <a href=\"https://sentry.io/\"><img src=\"./packages/twenty-website/public/images/readme/sentry.webp\" height=\"28\" alt=\"Sentry\" /></a>\n  &nbsp;&nbsp;&nbsp;&nbsp;\n  <a href=\"https://crowdin.com/\"><img src=\"./packages/twenty-website/public/images/readme/crowdin.webp\" height=\"28\" alt=\"Crowdin\" /></a>\n</p>\n\nThanks to these amazing services that we use and recommend for code review (Greptile), catching bugs (Sentry) and translating (Crowdin).\n\n# Join the Community\n\n<p><a href=\"https://github.com/twentyhq/twenty\"><img src=\"./packages/twenty-website/public/images/readme/star-icon.svg\" width=\"12\" height=\"12\"/> Star the repo</a> · <a href=\"https://discord.gg/cx5n4Jzs57\"><img src=\"./packages/twenty-website/public/images/readme/discord-icon.svg\" width=\"12\" height=\"12\"/> Discord</a> · <a href=\"https://github.com/twentyhq/twenty/discussions\"><img src=\"./packages/twenty-website/public/images/readme/message-icon.svg\" width=\"12\" height=\"12\"/> Feature requests</a> · <a href=\"https://github.com/orgs/twentyhq/projects/1/views/35\"><img src=\"./packages/twenty-website/public/images/readme/rocket-icon.svg\" width=\"12\" height=\"12\"/> Releases</a> · <a href=\"https://twitter.com/twentycrm\"><img src=\"./packages/twenty-website/public/images/readme/x-icon.svg\" width=\"12\" height=\"12\"/> X</a> · <a href=\"https://www.linkedin.com/company/twenty/\"><img src=\"./packages/twenty-website/public/images/readme/linkedin-icon.svg\" width=\"12\" height=\"12\"/> LinkedIn</a> · <a href=\"https://twenty.crowdin.com/twenty\"><img src=\"./packages/twenty-website/public/images/readme/language-icon.svg\" width=\"12\" height=\"12\"/> Crowdin</a> · <a href=\"https://github.com/twentyhq/twenty/contribute\"><img src=\"./packages/twenty-website/public/images/readme/code-icon.svg\" width=\"12\" height=\"12\"/> Contribute</a></p>\n",
  "bytes": 11978,
  "sha": "5c8dc531b01f1bedddb73acba2181252042d0fc663595bda9214c447617627bb",
  "repo_slug": "twentyhq/twenty",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_twentyhq_twenty_manage_app_84835486/readme"
}