![](\"https://storage.googleapis.com/mabl-email-static-assets/mabl_logo_horizontal_light.png\"){kind=logo}
\n\n \n
\nmabl helps you create and run reliable end-to-end tests earlier and more often in the development cycle - without disrupting your workflow.\n
\n\n# mabl CLI\n\n## Description\n\nmabl CLI gives you everything you need to create, edit and run end-to-end tests\nlocally and in the mabl cloud. Install the `mabl-cli` from `npm` to create and\nrun tests with a few simple commands. Query your workspaces, applications,\nenvironments, and tests all through the command line.\n\n### Supported Features\n\n- **Create** and **Edit** mabl tests from the command line, including saving\n changes to a mabl branch\n- **Run** headless tests locally or in your CI environment grouped by label or a\n plan\n- **Deployments** can trigger test plan runs in the mabl cloud on a deployment\n event in your CI/CD pipeline\n- **Export** and download all screenshots for a test run as a zip file\n- **Import** Selenium-based tests to mabl\n- **Export** mabl tests to Selenium IDE\n- **List** and **Describe** mabl entities (e.g. tests, branches, plans,\n environments, applications, workspaces, etc.)\n\n## Help Documentation\n\nComplete help documentation available at\n[help.mabl.com/docs/mabl-cli](https://help.mabl.com/docs/mabl-cli).\n\n## Installation\n\nNote: **Node 18+ is required** to run the mabl CLI\n\nStable version:\n\n```bash\nnpm i -g @mablhq/mabl-cli\n```\n\nTo upgrade to the latest stable version:\n\n```bash\nnpm i -g @mablhq/mabl-cli@latest\n```\n\n## Usage\n\n### Authenticate\n\n#### User Authentication\n\n```bash\nmabl auth login\n```\n\nAuthenticate in the launched browser window\n\n#### Machine User Authentication\n\nMachine users can add the `--api-key