CINXE.COM
<!doctype html> <html x-doc-route="/cli/workspaces/list" lang="en" dir="ltr" class="docs-wrapper plugin-yarn-cli-docs plugin-id-default docs-version-current docs-doc-page docs-doc-id-cli/workspaces/list" data-has-hydrated="false"> <head> <meta charset="UTF-8"> <meta name="generator" content="Docusaurus v3.4.0"> <title data-rh="true">yarn workspaces list | Yarn</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://yarnpkg.com/img/social-preview.png"><meta data-rh="true" name="twitter:image" content="https://yarnpkg.com/img/social-preview.png"><meta data-rh="true" property="og:url" content="https://yarnpkg.com/cli/workspaces/list"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="yarn workspaces list | Yarn"><meta data-rh="true" name="description" content="List all available workspaces."><meta data-rh="true" property="og:description" content="List all available workspaces."><link data-rh="true" rel="icon" href="/img/yarn-favicon.svg"><link data-rh="true" rel="canonical" href="https://yarnpkg.com/cli/workspaces/list"><link data-rh="true" rel="alternate" href="https://yarnpkg.com/cli/workspaces/list" hreflang="en"><link data-rh="true" rel="alternate" href="https://yarnpkg.com/cli/workspaces/list" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://STXW7VT1S5-dsn.algolia.net" crossorigin="anonymous"><link rel="alternate" type="application/rss+xml" href="/blog/rss.xml" title="Yarn RSS Feed"> <link rel="alternate" type="application/atom+xml" href="/blog/atom.xml" title="Yarn Atom Feed"> <link rel="search" type="application/opensearchdescription+xml" title="Yarn" href="/opensearch.xml"> <script src="/js/custom.js"></script><link rel="stylesheet" href="/assets/css/styles.1549fd9f.css"> <script src="/assets/js/runtime~main.ed540d95.js" defer="defer"></script> <script src="/assets/js/main.8d1417ce.js" defer="defer"></script> </head> <body class="navigation-with-keyboard"> <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();t(null!==e?e:"light")}(),function(){try{const n=new URLSearchParams(window.location.search).entries();for(var[t,e]of n)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()</script><div id="__docusaurus"><div role="region" aria-label="Skip to main content"><a class="skipToContent_VNyr" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><div class="navbar__logo"><img src="data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4KPHN2ZyBpZD0iTGF5ZXJfMSIgdmlld0JveD0iMCAwIDExNTQuOCA1MTgiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CiAgPHN0eWxlPi5zdDB7ZmlsbDojZmZmfS5zdDF7ZmlsbDpyZWR9PC9zdHlsZT4KICA8cGF0aCBjbGFzcz0ic3QwIiBkPSJNNzE4LjYgMjU3LjhjLTggMjcuNi0yMC44IDQ3LjYtMzUuMiA2My42VjE4MWMwLTkuNi04LjQtMTcuNi0yMS42LTE3LjYtNS42IDAtMTAuNCAyLjgtMTAuNCA2LjggMCAyLjggMS42IDUuMiAxLjYgMTIuOHY2NC40Yy00LjggMjgtMTYuOCA1NC0zMi44IDU0LTExLjYgMC0xOC40LTExLjYtMTguNC0zMy4yIDAtMzMuNiA0LjQtNTEuMiAxMS42LTgwLjggMS42LTYgMTMuMi0yMi02LjQtMjItMjEuMiAwLTE4LjQgOC0yMS4yIDE0LjggMCAwLTEzLjQgNDcuNi0xMy40IDkwIDAgMzQuOCAxNC42IDU3LjYgNDEuNCA1Ny42IDE3LjIgMCAyOS42LTExLjYgMzkuMi0yNy42VjM1MWMtMjYuNCAyMy4yLTQ5LjYgNDMuNi00OS42IDg0IDAgMjUuNiAxNiA0NiAzOC40IDQ2IDIwLjQgMCA0MS42LTE0LjggNDEuNi01Ni44VjM1NWMyMS42LTE4LjggNDQuOC00Mi40IDU4LjQtODguOC40LTEuNi40LTMuNi40LTQgMC03LjYtNy42LTE2LjQtMTQtMTYuNC00IDAtNy4yIDMuNi05LjYgMTJ6bS03Ni44IDE5OGMtNi40IDAtMTAuNC05LjYtMTAuNC0yMiAwLTI0IDguOC0zOS4yIDIxLjYtNTIuNHY0Mi44YzAgNy42IDEuNiAzMS42LTExLjIgMzEuNnoiLz4KICA8cGF0aCBjbGFzcz0ic3QwIiBkPSJNODMzLjQgMzAxYy05LjYgMC0xMy42LTkuNi0xMy42LTE4LjR2LTY2YzAtOS42LTguNC0xNy42LTIxLjYtMTcuNi01LjYgMC0xMC40IDIuOC0xMC40IDYuOCAwIDIuOCAxLjYgNS4yIDEuNiAxMi44djYxLjZDNzg1IDI5MS40IDc3Ny44IDMwMSA3NjcgMzAxYy0xNCAwLTIyLjgtMTItMjIuOC0zMi44IDAtNTcuNiAzNS42LTgzLjYgNjYtODMuNiA0IDAgOCAuOCAxMS42LjggNCAwIDUuMi0yLjQgNS4yLTkuMiAwLTEwLjQtNy42LTE2LjgtMTguNC0xNi44LTQ4LjggMC05NS4yIDQwLjgtOTUuMiAxMDcuNiAwIDM0IDE2LjQgNjAuNCA0Ny42IDYwLjQgMTUuMiAwIDI2LjQtNy4yIDM0LjQtMTYuNCA2IDkuNiAxNi44IDE2LjQgMzAuOCAxNi40IDM0LjQgMCA1MC40LTM2IDU3LjItNjIuNC40LTEuNi40LTIuNC40LTIuOCAwLTcuNi03LjYtMTYuNC0xNC0xNi40LTQgMC04IDMuNi05LjYgMTItMy42IDE3LjYtMTAuOCA0My4yLTI2LjggNDMuMnoiLz4KICA8cGF0aCBjbGFzcz0ic3QwIiBkPSJNOTQ5IDMyNy40YzM0LjQgMCA1MC0zNiA1Ny4yLTYyLjQgMC0uOC40LTEuNi40LTIuOCAwLTcuNi03LjYtMTYuNC0xNC0xNi40LTQgMC04IDMuNi05LjYgMTItMy42IDE3LjYtMTAuNCA0My4yLTI4LjggNDMuMi0xMC44IDAtMTYtMTAuNC0xNi0yMS42IDAtNDAgMTgtODcuMiAxOC05MiAxLjYtOS4yLTE0LjQtMjIuNC0xOS4yLTIyLjRoLTIwLjhjLTQgMC04IDAtMjEuMi0xLjYtNC40LTE2LjQtMTUuNi0yMS4yLTI1LjItMjEuMi0xMC40IDAtMjAgNy4yLTIwIDE4LjQgMCAxMS42IDcuMiAyMCAxNy4yIDI1LjYtLjQgMjAuNC0yIDUzLjYtNi40IDY5LjYtMy42IDEzLjYgMTcuMiAyOCAyMi40IDExLjIgNy4yLTIzLjIgOS42LTU4IDEwLTczLjZoMzQuOGMtMTIuOCAzNC40LTIwIDYyLjgtMjAgODguNCAwIDM1LjIgMjIuNCA0NS42IDQxLjIgNDUuNnoiLz4KICA8cGF0aCBjbGFzcz0ic3QwIiBkPSJNIDk4NC42IDE4MyBDIDk4NC42IDE3NS40IDk4MyAxNzMgOTgzIDE3MC4yIEMgOTgzIDE2Ni4yIDk4Ny44IDE2My40IDk5My40IDE2My40IEMgMTAwNi42IDE2My40IDEwMTUgMTcxLjQgMTAxNSAxODEgTCAxMDE1IDE5OSBDIDEwMjUuOCAxNzYuNiAxMDQwLjIgMTU5LjQgMTA1OS44IDE1OS40IEMgMTA4Ni42IDE1OS40IDEwOTMgMTgxLjQgMTA5MyAxOTkuOCBMIDEwOTMgMjgyLjYgQyAxMDkzIDI4Ni4yIDEwOTMgMzAxIDExMDMuNCAzMDEgQyAxMTE5LjQgMzAxIDExMjcuNiAyNzUuNCAxMTMxLjIgMjU3LjggQyAxMTMyLjggMjQ5LjQgMTEzNi44IDI0NS44IDExNDAuOCAyNDUuOCBDIDExNDcuMiAyNDUuOCAxMTU0LjggMjU0LjYgMTE1NC44IDI2Mi4yIEMgMTE1NC44IDI2Mi42IDExNTQuOCAyNjMuNCAxMTU0LjQgMjY1IEMgMTE0Ny42IDI5MS40IDExMzAuNiAzMjcuNCAxMDk2LjIgMzI3LjQgQyAxMDc1IDMyNy40IDEwNjIuNiAzMTAuMiAxMDYyLjYgMjg5LjggTCAxMDYyLjYgMjA4LjYgQyAxMDYyLjYgMTk2LjIgMTA2MS44IDE4NS44IDEwNTQuMiAxODUuOCBDIDEwNDIuNiAxODUuOCAxMDE3LjggMjIwLjIgMTAxNSAyNTEuOCBMIDEwMTUgMzEwLjIgQyAxMDE1IDMxNy44IDEwMTUuNCAzMjcuNCAxMDAzLjggMzI3LjQgQyA5OTUuOCAzMjcuNCA5ODQuNiAzMjQuNiA5ODQuNiAzMDkuOCBaIE0gMjU5IDAgQyA0MDIgMCA1MTggMTE2IDUxOCAyNTkgQyA1MTggNDAyIDQwMiA1MTggMjU5IDUxOCBDIDExNiA1MTggMCA0MDIgMCAyNTkgQyAwIDExNiAxMTYgMCAyNTkgMCBaIE0gNDM1LjIgMzM3LjUgQyA0MzMuNCAzMjMuMyA0MjEuNCAzMTMuNSA0MDYgMzEzLjcgQyAzODMgMzE0IDM2My43IDMyNS45IDM1MC45IDMzMy44IEMgMzQ1LjkgMzM2LjkgMzQxLjYgMzM5LjIgMzM3LjkgMzQwLjkgQyAzMzguNyAzMjkuMyAzMzggMzE0LjEgMzMyIDI5Ny40IEMgMzI0LjcgMjc3LjQgMzE0LjkgMjY1LjEgMzA3LjkgMjU4IEMgMzE2IDI0Ni4yIDMyNy4xIDIyOSAzMzIuMyAyMDIuNCBDIDMzNi44IDE3OS43IDMzNS40IDE0NC40IDMyNS4xIDEyNC42IEMgMzIzIDEyMC42IDMxOS41IDExNy43IDMxNS4xIDExNi41IEMgMzEzLjMgMTE2IDMwOS45IDExNSAzMDMuMiAxMTYuOSBDIDI5My4xIDk2IDI4OS42IDkzLjggMjg2LjkgOTIgQyAyODEuMyA4OC40IDI3NC43IDg3LjYgMjY4LjUgODkuOSBDIDI2MC4yIDkyLjkgMjUzLjEgMTAwLjkgMjQ2LjQgMTE1LjEgQyAyNDUuNCAxMTcuMiAyNDQuNSAxMTkuMiAyNDMuNyAxMjEuMiBDIDIzMSAxMjIuMSAyMTEgMTI2LjcgMTk0LjEgMTQ1IEMgMTkyIDE0Ny4zIDE4Ny45IDE0OSAxODMuNiAxNTAuNiBMIDE4My43IDE1MC42IEMgMTc0LjkgMTUzLjcgMTcwLjkgMTYwLjkgMTY2IDE3My45IEMgMTU5LjIgMTkyLjEgMTY2LjIgMjEwIDE3My4xIDIyMS42IEMgMTYzLjcgMjMwIDE1MS4yIDI0My40IDE0NC42IDI1OS4xIEMgMTM2LjQgMjc4LjUgMTM1LjUgMjk3LjUgMTM1LjggMzA3LjggQyAxMjguOCAzMTUuMiAxMTggMzI5LjEgMTE2LjggMzQ0LjcgQyAxMTUuMiAzNjYuNSAxMjMuMSAzODEuMyAxMjYuNiAzODYuNyBDIDEyNy42IDM4OC4zIDEyOC43IDM4OS42IDEyOS45IDM5MC45IEMgMTI5LjUgMzkzLjYgMTI5LjQgMzk2LjUgMTMwIDM5OS41IEMgMTMxLjMgNDA2LjUgMTM1LjcgNDEyLjIgMTQyLjQgNDE1LjggQyAxNTUuNiA0MjIuOCAxNzQgNDI1LjggMTg4LjIgNDE4LjcgQyAxOTMuMyA0MjQuMSAyMDIuNiA0MjkuMyAyMTkuNSA0MjkuMyBMIDIyMC41IDQyOS4zIEMgMjI0LjggNDI5LjMgMjc5LjQgNDI2LjQgMjk1LjMgNDIyLjUgQyAzMDIuNCA0MjAuOCAzMDcuMyA0MTcuOCAzMTAuNSA0MTUuMSBDIDMyMC43IDQxMS45IDM0OC45IDQwMi4zIDM3NS41IDM4NS4xIEMgMzk0LjMgMzcyLjkgNDAwLjggMzcwLjMgNDE0LjggMzY2LjkgQyA0MjguNCAzNjMuNiA0MzYuOSAzNTEuMiA0MzUuMiAzMzcuNSBaIE0gNDExLjQgMzUyLjIgQyAzOTUuNCAzNTYgMzg3LjMgMzU5LjUgMzY3LjUgMzcyLjQgQyAzMzYuNiAzOTIuNCAzMDIuOCA0MDEuNyAzMDIuOCA0MDEuNyBDIDMwMi44IDQwMS43IDMwMCA0MDUuOSAyOTEuOSA0MDcuOCBDIDI3Ny45IDQxMS4yIDIyNS4yIDQxNC4xIDIyMC40IDQxNC4yIEMgMjA3LjUgNDE0LjMgMTk5LjYgNDEwLjkgMTk3LjQgNDA1LjYgQyAxOTAuNyAzODkuNiAyMDcgMzgyLjYgMjA3IDM4Mi42IEMgMjA3IDM4Mi42IDIwMy40IDM4MC40IDIwMS4zIDM3OC40IEMgMTk5LjQgMzc2LjUgMTk3LjQgMzcyLjcgMTk2LjggMzc0LjEgQyAxOTQuMyAzODAuMiAxOTMgMzk1LjEgMTg2LjMgNDAxLjggQyAxNzcuMSA0MTEuMSAxNTkuNyA0MDggMTQ5LjQgNDAyLjYgQyAxMzguMSAzOTYuNiAxNTAuMiAzODIuNSAxNTAuMiAzODIuNSBDIDE1MC4yIDM4Mi41IDE0NC4xIDM4Ni4xIDEzOS4yIDM3OC43IEMgMTM0LjggMzcxLjkgMTMwLjcgMzYwLjMgMTMxLjggMzQ2IEMgMTMzIDMyOS43IDE1MS4yIDMxMy45IDE1MS4yIDMxMy45IEMgMTUxLjIgMzEzLjkgMTQ4IDI4OS44IDE1OC41IDI2NS4xIEMgMTY4IDI0Mi42IDE5My42IDIyNC41IDE5My42IDIyNC41IEMgMTkzLjYgMjI0LjUgMTcyLjEgMjAwLjcgMTgwLjEgMTc5LjMgQyAxODUuMyAxNjUuMyAxODcuNCAxNjUuNCAxODkuMSAxNjQuOCBDIDE5NS4xIDE2Mi41IDIwMC45IDE2MCAyMDUuMiAxNTUuMyBDIDIyNi43IDEzMi4xIDI1NC4xIDEzNi41IDI1NC4xIDEzNi41IEMgMjU0LjEgMTM2LjUgMjY3LjEgOTcgMjc5LjEgMTA0LjcgQyAyODIuOCAxMDcuMSAyOTYuMSAxMzYuNyAyOTYuMSAxMzYuNyBDIDI5Ni4xIDEzNi43IDMxMC4zIDEyOC40IDMxMS45IDEzMS41IEMgMzIwLjUgMTQ4LjIgMzIxLjUgMTgwLjEgMzE3LjcgMTk5LjUgQyAzMTEuMyAyMzEuNSAyOTUuMyAyNDguNyAyODguOSAyNTkuNSBDIDI4Ny40IDI2MiAzMDYuMSAyNjkuOSAzMTcuOSAzMDIuNiBDIDMyOC44IDMzMi41IDMxOS4xIDM1Ny42IDMyMC44IDM2MC40IEMgMzIxLjEgMzYwLjkgMzIxLjIgMzYxLjEgMzIxLjIgMzYxLjEgQyAzMjEuMiAzNjEuMSAzMzMuNyAzNjIuMSAzNTguOCAzNDYuNiBDIDM3Mi4yIDMzOC4zIDM4OC4xIDMyOSA0MDYuMiAzMjguOCBDIDQyMy43IDMyOC41IDQyNC42IDM0OSA0MTEuNCAzNTIuMiBaIi8+Cjwvc3ZnPg==" alt="Yarn Logo" class="themedComponent_u5Ak themedComponent--light_XT5U"><img src="data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4KPHN2ZyBpZD0iTGF5ZXJfMSIgdmlld0JveD0iMCAwIDExNTQuOCA1MTgiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CiAgPHN0eWxlPi5zdDB7ZmlsbDojZmZmfS5zdDF7ZmlsbDpyZWR9PC9zdHlsZT4KICA8cGF0aCBjbGFzcz0ic3QwIiBkPSJNNzE4LjYgMjU3LjhjLTggMjcuNi0yMC44IDQ3LjYtMzUuMiA2My42VjE4MWMwLTkuNi04LjQtMTcuNi0yMS42LTE3LjYtNS42IDAtMTAuNCAyLjgtMTAuNCA2LjggMCAyLjggMS42IDUuMiAxLjYgMTIuOHY2NC40Yy00LjggMjgtMTYuOCA1NC0zMi44IDU0LTExLjYgMC0xOC40LTExLjYtMTguNC0zMy4yIDAtMzMuNiA0LjQtNTEuMiAxMS42LTgwLjggMS42LTYgMTMuMi0yMi02LjQtMjItMjEuMiAwLTE4LjQgOC0yMS4yIDE0LjggMCAwLTEzLjQgNDcuNi0xMy40IDkwIDAgMzQuOCAxNC42IDU3LjYgNDEuNCA1Ny42IDE3LjIgMCAyOS42LTExLjYgMzkuMi0yNy42VjM1MWMtMjYuNCAyMy4yLTQ5LjYgNDMuNi00OS42IDg0IDAgMjUuNiAxNiA0NiAzOC40IDQ2IDIwLjQgMCA0MS42LTE0LjggNDEuNi01Ni44VjM1NWMyMS42LTE4LjggNDQuOC00Mi40IDU4LjQtODguOC40LTEuNi40LTMuNi40LTQgMC03LjYtNy42LTE2LjQtMTQtMTYuNC00IDAtNy4yIDMuNi05LjYgMTJ6bS03Ni44IDE5OGMtNi40IDAtMTAuNC05LjYtMTAuNC0yMiAwLTI0IDguOC0zOS4yIDIxLjYtNTIuNHY0Mi44YzAgNy42IDEuNiAzMS42LTExLjIgMzEuNnoiLz4KICA8cGF0aCBjbGFzcz0ic3QwIiBkPSJNODMzLjQgMzAxYy05LjYgMC0xMy42LTkuNi0xMy42LTE4LjR2LTY2YzAtOS42LTguNC0xNy42LTIxLjYtMTcuNi01LjYgMC0xMC40IDIuOC0xMC40IDYuOCAwIDIuOCAxLjYgNS4yIDEuNiAxMi44djYxLjZDNzg1IDI5MS40IDc3Ny44IDMwMSA3NjcgMzAxYy0xNCAwLTIyLjgtMTItMjIuOC0zMi44IDAtNTcuNiAzNS42LTgzLjYgNjYtODMuNiA0IDAgOCAuOCAxMS42LjggNCAwIDUuMi0yLjQgNS4yLTkuMiAwLTEwLjQtNy42LTE2LjgtMTguNC0xNi44LTQ4LjggMC05NS4yIDQwLjgtOTUuMiAxMDcuNiAwIDM0IDE2LjQgNjAuNCA0Ny42IDYwLjQgMTUuMiAwIDI2LjQtNy4yIDM0LjQtMTYuNCA2IDkuNiAxNi44IDE2LjQgMzAuOCAxNi40IDM0LjQgMCA1MC40LTM2IDU3LjItNjIuNC40LTEuNi40LTIuNC40LTIuOCAwLTcuNi03LjYtMTYuNC0xNC0xNi40LTQgMC04IDMuNi05LjYgMTItMy42IDE3LjYtMTAuOCA0My4yLTI2LjggNDMuMnoiLz4KICA8cGF0aCBjbGFzcz0ic3QwIiBkPSJNOTQ5IDMyNy40YzM0LjQgMCA1MC0zNiA1Ny4yLTYyLjQgMC0uOC40LTEuNi40LTIuOCAwLTcuNi03LjYtMTYuNC0xNC0xNi40LTQgMC04IDMuNi05LjYgMTItMy42IDE3LjYtMTAuNCA0My4yLTI4LjggNDMuMi0xMC44IDAtMTYtMTAuNC0xNi0yMS42IDAtNDAgMTgtODcuMiAxOC05MiAxLjYtOS4yLTE0LjQtMjIuNC0xOS4yLTIyLjRoLTIwLjhjLTQgMC04IDAtMjEuMi0xLjYtNC40LTE2LjQtMTUuNi0yMS4yLTI1LjItMjEuMi0xMC40IDAtMjAgNy4yLTIwIDE4LjQgMCAxMS42IDcuMiAyMCAxNy4yIDI1LjYtLjQgMjAuNC0yIDUzLjYtNi40IDY5LjYtMy42IDEzLjYgMTcuMiAyOCAyMi40IDExLjIgNy4yLTIzLjIgOS42LTU4IDEwLTczLjZoMzQuOGMtMTIuOCAzNC40LTIwIDYyLjgtMjAgODguNCAwIDM1LjIgMjIuNCA0NS42IDQxLjIgNDUuNnoiLz4KICA8cGF0aCBjbGFzcz0ic3QwIiBkPSJNIDk4NC42IDE4MyBDIDk4NC42IDE3NS40IDk4MyAxNzMgOTgzIDE3MC4yIEMgOTgzIDE2Ni4yIDk4Ny44IDE2My40IDk5My40IDE2My40IEMgMTAwNi42IDE2My40IDEwMTUgMTcxLjQgMTAxNSAxODEgTCAxMDE1IDE5OSBDIDEwMjUuOCAxNzYuNiAxMDQwLjIgMTU5LjQgMTA1OS44IDE1OS40IEMgMTA4Ni42IDE1OS40IDEwOTMgMTgxLjQgMTA5MyAxOTkuOCBMIDEwOTMgMjgyLjYgQyAxMDkzIDI4Ni4yIDEwOTMgMzAxIDExMDMuNCAzMDEgQyAxMTE5LjQgMzAxIDExMjcuNiAyNzUuNCAxMTMxLjIgMjU3LjggQyAxMTMyLjggMjQ5LjQgMTEzNi44IDI0NS44IDExNDAuOCAyNDUuOCBDIDExNDcuMiAyNDUuOCAxMTU0LjggMjU0LjYgMTE1NC44IDI2Mi4yIEMgMTE1NC44IDI2Mi42IDExNTQuOCAyNjMuNCAxMTU0LjQgMjY1IEMgMTE0Ny42IDI5MS40IDExMzAuNiAzMjcuNCAxMDk2LjIgMzI3LjQgQyAxMDc1IDMyNy40IDEwNjIuNiAzMTAuMiAxMDYyLjYgMjg5LjggTCAxMDYyLjYgMjA4LjYgQyAxMDYyLjYgMTk2LjIgMTA2MS44IDE4NS44IDEwNTQuMiAxODUuOCBDIDEwNDIuNiAxODUuOCAxMDE3LjggMjIwLjIgMTAxNSAyNTEuOCBMIDEwMTUgMzEwLjIgQyAxMDE1IDMxNy44IDEwMTUuNCAzMjcuNCAxMDAzLjggMzI3LjQgQyA5OTUuOCAzMjcuNCA5ODQuNiAzMjQuNiA5ODQuNiAzMDkuOCBaIE0gMjU5IDAgQyA0MDIgMCA1MTggMTE2IDUxOCAyNTkgQyA1MTggNDAyIDQwMiA1MTggMjU5IDUxOCBDIDExNiA1MTggMCA0MDIgMCAyNTkgQyAwIDExNiAxMTYgMCAyNTkgMCBaIE0gNDM1LjIgMzM3LjUgQyA0MzMuNCAzMjMuMyA0MjEuNCAzMTMuNSA0MDYgMzEzLjcgQyAzODMgMzE0IDM2My43IDMyNS45IDM1MC45IDMzMy44IEMgMzQ1LjkgMzM2LjkgMzQxLjYgMzM5LjIgMzM3LjkgMzQwLjkgQyAzMzguNyAzMjkuMyAzMzggMzE0LjEgMzMyIDI5Ny40IEMgMzI0LjcgMjc3LjQgMzE0LjkgMjY1LjEgMzA3LjkgMjU4IEMgMzE2IDI0Ni4yIDMyNy4xIDIyOSAzMzIuMyAyMDIuNCBDIDMzNi44IDE3OS43IDMzNS40IDE0NC40IDMyNS4xIDEyNC42IEMgMzIzIDEyMC42IDMxOS41IDExNy43IDMxNS4xIDExNi41IEMgMzEzLjMgMTE2IDMwOS45IDExNSAzMDMuMiAxMTYuOSBDIDI5My4xIDk2IDI4OS42IDkzLjggMjg2LjkgOTIgQyAyODEuMyA4OC40IDI3NC43IDg3LjYgMjY4LjUgODkuOSBDIDI2MC4yIDkyLjkgMjUzLjEgMTAwLjkgMjQ2LjQgMTE1LjEgQyAyNDUuNCAxMTcuMiAyNDQuNSAxMTkuMiAyNDMuNyAxMjEuMiBDIDIzMSAxMjIuMSAyMTEgMTI2LjcgMTk0LjEgMTQ1IEMgMTkyIDE0Ny4zIDE4Ny45IDE0OSAxODMuNiAxNTAuNiBMIDE4My43IDE1MC42IEMgMTc0LjkgMTUzLjcgMTcwLjkgMTYwLjkgMTY2IDE3My45IEMgMTU5LjIgMTkyLjEgMTY2LjIgMjEwIDE3My4xIDIyMS42IEMgMTYzLjcgMjMwIDE1MS4yIDI0My40IDE0NC42IDI1OS4xIEMgMTM2LjQgMjc4LjUgMTM1LjUgMjk3LjUgMTM1LjggMzA3LjggQyAxMjguOCAzMTUuMiAxMTggMzI5LjEgMTE2LjggMzQ0LjcgQyAxMTUuMiAzNjYuNSAxMjMuMSAzODEuMyAxMjYuNiAzODYuNyBDIDEyNy42IDM4OC4zIDEyOC43IDM4OS42IDEyOS45IDM5MC45IEMgMTI5LjUgMzkzLjYgMTI5LjQgMzk2LjUgMTMwIDM5OS41IEMgMTMxLjMgNDA2LjUgMTM1LjcgNDEyLjIgMTQyLjQgNDE1LjggQyAxNTUuNiA0MjIuOCAxNzQgNDI1LjggMTg4LjIgNDE4LjcgQyAxOTMuMyA0MjQuMSAyMDIuNiA0MjkuMyAyMTkuNSA0MjkuMyBMIDIyMC41IDQyOS4zIEMgMjI0LjggNDI5LjMgMjc5LjQgNDI2LjQgMjk1LjMgNDIyLjUgQyAzMDIuNCA0MjAuOCAzMDcuMyA0MTcuOCAzMTAuNSA0MTUuMSBDIDMyMC43IDQxMS45IDM0OC45IDQwMi4zIDM3NS41IDM4NS4xIEMgMzk0LjMgMzcyLjkgNDAwLjggMzcwLjMgNDE0LjggMzY2LjkgQyA0MjguNCAzNjMuNiA0MzYuOSAzNTEuMiA0MzUuMiAzMzcuNSBaIE0gNDExLjQgMzUyLjIgQyAzOTUuNCAzNTYgMzg3LjMgMzU5LjUgMzY3LjUgMzcyLjQgQyAzMzYuNiAzOTIuNCAzMDIuOCA0MDEuNyAzMDIuOCA0MDEuNyBDIDMwMi44IDQwMS43IDMwMCA0MDUuOSAyOTEuOSA0MDcuOCBDIDI3Ny45IDQxMS4yIDIyNS4yIDQxNC4xIDIyMC40IDQxNC4yIEMgMjA3LjUgNDE0LjMgMTk5LjYgNDEwLjkgMTk3LjQgNDA1LjYgQyAxOTAuNyAzODkuNiAyMDcgMzgyLjYgMjA3IDM4Mi42IEMgMjA3IDM4Mi42IDIwMy40IDM4MC40IDIwMS4zIDM3OC40IEMgMTk5LjQgMzc2LjUgMTk3LjQgMzcyLjcgMTk2LjggMzc0LjEgQyAxOTQuMyAzODAuMiAxOTMgMzk1LjEgMTg2LjMgNDAxLjggQyAxNzcuMSA0MTEuMSAxNTkuNyA0MDggMTQ5LjQgNDAyLjYgQyAxMzguMSAzOTYuNiAxNTAuMiAzODIuNSAxNTAuMiAzODIuNSBDIDE1MC4yIDM4Mi41IDE0NC4xIDM4Ni4xIDEzOS4yIDM3OC43IEMgMTM0LjggMzcxLjkgMTMwLjcgMzYwLjMgMTMxLjggMzQ2IEMgMTMzIDMyOS43IDE1MS4yIDMxMy45IDE1MS4yIDMxMy45IEMgMTUxLjIgMzEzLjkgMTQ4IDI4OS44IDE1OC41IDI2NS4xIEMgMTY4IDI0Mi42IDE5My42IDIyNC41IDE5My42IDIyNC41IEMgMTkzLjYgMjI0LjUgMTcyLjEgMjAwLjcgMTgwLjEgMTc5LjMgQyAxODUuMyAxNjUuMyAxODcuNCAxNjUuNCAxODkuMSAxNjQuOCBDIDE5NS4xIDE2Mi41IDIwMC45IDE2MCAyMDUuMiAxNTUuMyBDIDIyNi43IDEzMi4xIDI1NC4xIDEzNi41IDI1NC4xIDEzNi41IEMgMjU0LjEgMTM2LjUgMjY3LjEgOTcgMjc5LjEgMTA0LjcgQyAyODIuOCAxMDcuMSAyOTYuMSAxMzYuNyAyOTYuMSAxMzYuNyBDIDI5Ni4xIDEzNi43IDMxMC4zIDEyOC40IDMxMS45IDEzMS41IEMgMzIwLjUgMTQ4LjIgMzIxLjUgMTgwLjEgMzE3LjcgMTk5LjUgQyAzMTEuMyAyMzEuNSAyOTUuMyAyNDguNyAyODguOSAyNTkuNSBDIDI4Ny40IDI2MiAzMDYuMSAyNjkuOSAzMTcuOSAzMDIuNiBDIDMyOC44IDMzMi41IDMxOS4xIDM1Ny42IDMyMC44IDM2MC40IEMgMzIxLjEgMzYwLjkgMzIxLjIgMzYxLjEgMzIxLjIgMzYxLjEgQyAzMjEuMiAzNjEuMSAzMzMuNyAzNjIuMSAzNTguOCAzNDYuNiBDIDM3Mi4yIDMzOC4zIDM4OC4xIDMyOSA0MDYuMiAzMjguOCBDIDQyMy43IDMyOC41IDQyNC42IDM0OSA0MTEuNCAzNTIuMiBaIi8+Cjwvc3ZnPg==" alt="Yarn Logo" class="themedComponent_u5Ak themedComponent--dark_Ka8T"></div><b class="navbar__title text--truncate">Yarn</b></a><a class="navbar__item navbar__link" href="/getting-started">Get Started</a><a class="navbar__item navbar__link" href="/features/caching">Features</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/cli">CLI</a><a class="navbar__item navbar__link" href="/configuration/manifest">Configuration</a><a class="navbar__item navbar__link" href="/advanced/error-codes">Advanced</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" href="/api">API</a></div><div class="navbar__items navbar__items--right"><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a class="navbar__link" aria-haspopup="true" aria-expanded="false" role="button" href="/getting-started">master (4.5.3-dev)</a><ul class="dropdown__menu"><li><a aria-current="page" class="dropdown__link dropdown__link--active" href="/getting-started">master (4.5.3-dev)</a></li><li><a href="https://v3.yarnpkg.com" target="_blank" rel="noopener noreferrer" class="dropdown__link">3.8.6<svg width="12" height="12" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_XYcw"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li><a href="https://classic.yarnpkg.com/en/docs" target="_blank" rel="noopener noreferrer" class="dropdown__link">1.22.22<svg width="12" height="12" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_XYcw"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><a href="https://discord.gg/yarnpkg" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">Discord<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_XYcw"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a><a href="https://github.com/yarnpkg/berry" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_XYcw"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a><div class="navbarSearchContainer_Lyxt"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><svg width="20" height="20" class="DocSearch-Search-Icon" viewBox="0 0 20 20"><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke="currentColor" fill="none" fill-rule="evenodd" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"></span></button></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="main-wrapper mainWrapper_CMyW"><div class="docsWrapper_bSxm"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_69Hm" type="button"></button><div class="docRoot_cWv0"><aside class="theme-doc-sidebar-container docSidebarContainer_Sb1_"><div class="sidebarViewport_l2Qt"><div class="sidebar_H7mn"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_sbrg"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--active" href="/cli">@yarnpkg/cli</a></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/add">yarn add</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/bin">yarn bin</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/cache/clean">yarn cache clean</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/config">yarn config</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/config/get">yarn config get</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/config/set">yarn config set</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/config/unset">yarn config unset</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/constraints">yarn constraints</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/constraints/query">yarn constraints query</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/constraints/source">yarn constraints source</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/dedupe">yarn dedupe</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/dlx">yarn dlx</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/exec">yarn exec</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/explain">yarn explain</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/explain/peer-requirements">yarn explain peer-requirements</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/info">yarn info</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/init">yarn init</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/install">yarn install</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/link">yarn link</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/node">yarn node</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/npm/audit">yarn npm audit</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/npm/info">yarn npm info</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/npm/login">yarn npm login</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/npm/logout">yarn npm logout</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/npm/publish">yarn npm publish</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/npm/tag/add">yarn npm tag add</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/npm/tag/list">yarn npm tag list</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/npm/tag/remove">yarn npm tag remove</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/npm/whoami">yarn npm whoami</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/pack">yarn pack</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/patch">yarn patch</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/patch-commit">yarn patch-commit</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/plugin/check">yarn plugin check</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/plugin/import">yarn plugin import</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/plugin/import/from/sources">yarn plugin import from sources</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/plugin/list">yarn plugin list</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/plugin/remove">yarn plugin remove</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/plugin/runtime">yarn plugin runtime</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/rebuild">yarn rebuild</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/remove">yarn remove</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/run">yarn run</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/search">yarn search</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/set/resolution">yarn set resolution</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/set/version">yarn set version</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/set/version/from/sources">yarn set version from sources</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/stage">yarn stage</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/unlink">yarn unlink</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/unplug">yarn unplug</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/up">yarn up</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/upgrade-interactive">yarn upgrade-interactive</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/version">yarn version</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/version/apply">yarn version apply</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/version/check">yarn version check</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/why">yarn why</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/workspace">yarn workspace</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/workspaces/focus">yarn workspaces focus</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/workspaces/foreach">yarn workspaces foreach</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/cli/workspaces/list">yarn workspaces list</a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link" href="/cli/builder">@yarnpkg/builder</a></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/builder/build/bundle">yarn builder build bundle</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/builder/build/plugin">yarn builder build plugin</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/builder/new/plugin">yarn builder new plugin</a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link" href="/cli/pnpify">@yarnpkg/pnpify</a></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/pnpify/run">yarn pnpify run</a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link" href="/cli/sdks">@yarnpkg/sdks</a></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/cli/sdks/default">yarn sdks</a></li></ul></li></ul></nav></div></div></aside><main class="docMainContainer_mc2i"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_OnZ6"><div class="docItemContainer_I85P"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_jPbZ" aria-label="Breadcrumbs"><ul class="breadcrumbs" itemscope="" itemtype="https://schema.org/BreadcrumbList"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_shmk"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item"><a class="breadcrumbs__link" itemprop="item" href="/cli"><span itemprop="name">@yarnpkg/cli</span></a><meta itemprop="position" content="1"></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link" itemprop="name">yarn workspaces list</span><meta itemprop="position" content="2"></li></ul></nav><div class="tocCollapsible_atEM theme-doc-toc-mobile tocMobile_rFVJ"><button type="button" class="clean-btn tocCollapsibleButton_FCxV">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>yarn workspaces list</h1></header><div class="subtitle"><p>List all available workspaces.</p></div> <h2 class="anchor anchorWithStickyNavbar_ATBP" id="usage">Usage<a class="hash-link" aria-label="Direct link to Usage" title="Direct link to Usage" href="/cli/workspaces/list#usage"></a></h2> <div class="terminal-code"><pre tabindex="0" class="codeBlockStandalone_xQ8c thin-scrollbar codeBlockContainer_EXcq theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><code class="codeBlockLines_PG5o"><div><span style="font-weight:bold;user-select:none">$ </span>yarn workspaces list</div></code></pre></div> <h2 class="anchor anchorWithStickyNavbar_ATBP" id="details">Details<a class="hash-link" aria-label="Direct link to Details" title="Direct link to Details" href="/cli/workspaces/list#details"></a></h2> <p>This command will print the list of all workspaces in the project.</p> <ul> <li> <p>If <code>--since</code> is set, Yarn will only list workspaces that have been modified since the specified ref. By default Yarn will use the refs specified by the <code data-tooltip-id="tooltip" data-tooltip-content="List of git refs against which Yarn will compare your branch when it needs to detect changes."><a class="key_FEvO" href="/configuration/yarnrc#changesetBaseRefs">changesetBaseRefs</a></code> configuration option.</p> </li> <li> <p>If <code>-R,--recursive</code> is set, Yarn will find workspaces to run the command on by recursively evaluating <code data-tooltip-id="tooltip" data-tooltip-content="Set of dependencies that must be made available to the current package in order for it to work properly."><a class="key_FEvO" href="/configuration/manifest#dependencies">dependencies</a></code> and <code data-tooltip-id="tooltip" data-tooltip-content="Set of dependencies that must be made available to the current package in order for it to work properly as a workspace."><a class="key_FEvO" href="/configuration/manifest#devDependencies">devDependencies</a></code> fields, instead of looking at the <code data-tooltip-id="tooltip" data-tooltip-content="Array of folder glob patterns referencing the workspaces of the project."><a class="key_FEvO" href="/configuration/manifest#workspaces">workspaces</a></code> fields.</p> </li> <li> <p>If <code>--no-private</code> is set, Yarn will not list any workspaces that have the <code data-tooltip-id="tooltip" data-tooltip-content="Define whether the package is meant to be published."><a class="key_FEvO" href="/configuration/manifest#private">private</a></code> field set to <code>true</code>.</p> </li> <li> <p>If both the <code>-v,--verbose</code> and <code>--json</code> options are set, Yarn will also return the cross-dependencies between each workspaces (useful when you wish to automatically generate Buck / Bazel rules).</p> </li> </ul> <h2 class="anchor anchorWithStickyNavbar_ATBP" id="options">Options<a class="hash-link" aria-label="Direct link to Options" title="Direct link to Options" href="/cli/workspaces/list#options"></a></h2> <table><thead><tr><th>Definition</th><th>Description</th></tr></thead><tbody><tr><td><h4 id="options-since" class="header-code"><code class="language-text">--since</code></h4></td><td>Only include workspaces that have been changed since the specified ref.</td></tr><tr><td><h4 id="options-R%2C-recursive" class="header-code"><code class="language-text">-R,--recursive</code></h4></td><td>Find packages via dependencies/devDependencies instead of using the workspaces field</td></tr><tr><td><h4 id="options-no-private" class="header-code"><code class="language-text">--no-private</code></h4></td><td>Exclude workspaces that have the private field set to true</td></tr><tr><td><h4 id="options-v%2C-verbose" class="header-code"><code class="language-text">-v,--verbose</code></h4></td><td>Also return the cross-dependencies between workspaces</td></tr><tr><td><h4 id="options-json" class="header-code"><code class="language-text">--json</code></h4></td><td>Format the output as an NDJSON stream</td></tr></tbody></table></div></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"></nav></div></div><div class="col col--3"><div class="tableOfContents_Pn2_ thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a class="table-of-contents__link toc-highlight" href="/cli/workspaces/list#usage">Usage</a></li><li><a class="table-of-contents__link toc-highlight" href="/cli/workspaces/list#details">Details</a></li><li><a class="table-of-contents__link toc-highlight" href="/cli/workspaces/list#options">Options</a></li></ul></div></div></div></div></main></div></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2024 Yarn Contributors, Inc. Built with Docusaurus.</div></div></div></footer></div> </body> </html>