PHPackages                             statamic/cli - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. statamic/cli

ActiveLibrary[CLI & Console](/categories/cli)

statamic/cli
============

Statamic CLI Tool

3.6.3(2mo ago)7587.7k↓11.8%21[6 issues](https://github.com/statamic/cli/issues)MITPHPPHP ^8.1CI passing

Since Jul 6Pushed 2mo ago8 watchersCompare

[ Source](https://github.com/statamic/cli)[ Packagist](https://packagist.org/packages/statamic/cli)[ RSS](/packages/statamic-cli/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (12)Versions (38)Used By (0)

Statamic CLI Tool
=================

[](#statamic-cli-tool)

🌴 Install and manage your **Statamic** projects from the command line.

- [Installing the CLI tool](#installing-the-cli-tool)
- [Using the CLI tool](#using-the-cli-tool)
    - [Installing Statamic](#installing-statamic)
    - [Checking Statamic versions](#checking-statamic-versions)
    - [Updating Statamic](#updating-statamic)

Installing the CLI tool
-----------------------

[](#installing-the-cli-tool)

```
composer global require statamic/cli

```

Make sure to place Composer's system-wide vendor bin directory in your `$PATH` so the `statamic` executable can be located by your system. [Here's how](https://statamic.dev/troubleshooting/command-not-found-statamic).

Once installed, you should be able to run `statamic {command name}` from within any directory.

### GitHub authentication

[](#github-authentication)

When you install starter kits, the CLI might present you with a warning that the GitHub API limit is reached. [Generate a Personal access token](https://github.com/settings/tokens/new) and paste it in your terminal with this command so Composer will save it for future use:

```
composer config --global --auth github-oauth.github.com [your_token_here]
```

Read more on this in the [Composer Docs](https://getcomposer.org/doc/articles/authentication-for-private-packages.md).

Updating the CLI tool
---------------------

[](#updating-the-cli-tool)

```
composer global update statamic/cli

```

Run this command to update the CLI tool to the most recent published version. If there's been a major version release, you may need to run `require` instead of update.

Using the CLI tool
------------------

[](#using-the-cli-tool)

### Installing Statamic

[](#installing-statamic)

You may create a new Statamic site with the `new` command:

```
statamic new my-site

```

This will present you with a list of supported starter kits to select from. Upon selection, the latest version will be downloaded and installed into the `my-site` directory.

You may also pass an explicit starter kit repo if you wish to skip the selection prompt:

```
statamic new my-site statamic/starter-kit-cool-writings

```

### Checking Statamic versions

[](#checking-statamic-versions)

From within an existing Statamic project root directory, you may run the following command to quickly find out which version is being used.

```
statamic version

```

### Updating Statamic

[](#updating-statamic)

From within an existing Statamic project root directory, you may use the following command to update to the latest version.

```
statamic update

```

This is just syntactic sugar for the `composer update statamic/cms --with-dependencies` command.

###  Health Score

64

—

FairBetter than 99% of packages

Maintenance86

Actively maintained with recent releases

Popularity46

Moderate usage in the ecosystem

Community25

Small or concentrated contributor base

Maturity84

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~96 days

Total

34

Last Release

63d ago

Major Versions

1.0.5 → v2.x-dev2020-01-15

1.0.6 → 2.0.02020-10-15

2.6.0 → 3.0.02023-08-14

PHP version history (2 changes)2.0.0PHP >=7.2.5

3.0.0PHP ^8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/44739?v=4)[Jack McDade](/maintainers/jackmcdade)[@jackmcdade](https://github.com/jackmcdade)

![](https://avatars.githubusercontent.com/u/1669353?v=4)[Statamic](/maintainers/statamic)[@statamic](https://github.com/statamic)

---

Top Contributors

[![jesseleite](https://avatars.githubusercontent.com/u/5187394?v=4)](https://github.com/jesseleite "jesseleite (63 commits)")[![jasonvarga](https://avatars.githubusercontent.com/u/105211?v=4)](https://github.com/jasonvarga "jasonvarga (58 commits)")[![duncanmcclean](https://avatars.githubusercontent.com/u/19637309?v=4)](https://github.com/duncanmcclean "duncanmcclean (16 commits)")[![jackmcdade](https://avatars.githubusercontent.com/u/44739?v=4)](https://github.com/jackmcdade "jackmcdade (11 commits)")[![robdekort](https://avatars.githubusercontent.com/u/69107412?v=4)](https://github.com/robdekort "robdekort (5 commits)")[![jonassiewertsen](https://avatars.githubusercontent.com/u/38906163?v=4)](https://github.com/jonassiewertsen "jonassiewertsen (3 commits)")[![benfurfie](https://avatars.githubusercontent.com/u/10786699?v=4)](https://github.com/benfurfie "benfurfie (3 commits)")[![joshuablum](https://avatars.githubusercontent.com/u/3824203?v=4)](https://github.com/joshuablum "joshuablum (3 commits)")[![alwaysblank](https://avatars.githubusercontent.com/u/23412884?v=4)](https://github.com/alwaysblank "alwaysblank (2 commits)")[![lbennett-stacki](https://avatars.githubusercontent.com/u/5678671?v=4)](https://github.com/lbennett-stacki "lbennett-stacki (1 commits)")[![marcorieser](https://avatars.githubusercontent.com/u/2395800?v=4)](https://github.com/marcorieser "marcorieser (1 commits)")[![amiuhle](https://avatars.githubusercontent.com/u/460091?v=4)](https://github.com/amiuhle "amiuhle (1 commits)")[![rossalexander](https://avatars.githubusercontent.com/u/73596879?v=4)](https://github.com/rossalexander "rossalexander (1 commits)")

---

Tags

cliinstallerstatamicstatamic

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/statamic-cli/health.svg)

```
[![Health](https://phpackages.com/badges/statamic-cli/health.svg)](https://phpackages.com/packages/statamic-cli)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.7k509.9M17.0k](/packages/laravel-framework)[illuminate/console

The Illuminate Console package.

12944.1M5.1k](/packages/illuminate-console)[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k36.7M259](/packages/laravel-dusk)[laravel/envoy

Elegant SSH tasks for PHP.

1.6k5.5M18](/packages/laravel-envoy)[laravel-zero/framework

The Laravel Zero Framework.

3371.4M369](/packages/laravel-zero-framework)[laravel/installer

Laravel application installer.

83610.7M20](/packages/laravel-installer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)