PHPackages                             jameslevi/atmos - 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. jameslevi/atmos

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

jameslevi/atmos
===============

Is a simple library for creating command line scripts in PHP.

v1.0.4(5y ago)2281MITPHPPHP >=5.3.0

Since Apr 3Pushed 5y ago1 watchersCompare

[ Source](https://github.com/jameslevi/atmos)[ Packagist](https://packagist.org/packages/jameslevi/atmos)[ RSS](/packages/jameslevi-atmos/feed)WikiDiscussions main Synced 5d ago

READMEChangelog (6)Dependencies (1)Versions (7)Used By (1)

Atmos
=====

[](#atmos)

[![](https://camo.githubusercontent.com/b3b83094dee4051a4d82d66eada7383757d339707f4cb927bc3801c0381476ab/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7061636b61676973742d76312e302e342d696e666f726d6174696f6e616c3f7374796c653d666c6174266c6f676f3d2533434c4f474f5f4e414d45253345266c6f676f436f6c6f723d776869746526636f6c6f723d326262633861)](https://camo.githubusercontent.com/b3b83094dee4051a4d82d66eada7383757d339707f4cb927bc3801c0381476ab/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7061636b61676973742d76312e302e342d696e666f726d6174696f6e616c3f7374796c653d666c6174266c6f676f3d2533434c4f474f5f4e414d45253345266c6f676f436f6c6f723d776869746526636f6c6f723d326262633861) [![](https://camo.githubusercontent.com/b4344b50cc4d00bc34f5209dfc527e7180da7c06507ab149bddbe79d0313e021/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d696e666f726d6174696f6e616c3f7374796c653d666c6174266c6f676f3d2533434c4f474f5f4e414d45253345266c6f676f436f6c6f723d776869746526636f6c6f723d326262633861)](https://camo.githubusercontent.com/b4344b50cc4d00bc34f5209dfc527e7180da7c06507ab149bddbe79d0313e021/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d696e666f726d6174696f6e616c3f7374796c653d666c6174266c6f676f3d2533434c4f474f5f4e414d45253345266c6f676f436f6c6f723d776869746526636f6c6f723d326262633861)

Is a simple library for creating command line scripts in PHP.

Features
--------

[](#features)

1. Create good looking PHP command line scripts.
2. Built-in commands to make web development much easier.
3. Easy integration with any PHP frameworks.

Installation
------------

[](#installation)

1. You can install via composer.

```
composer require jameslevi/atmos

```

2. Copy the atmos file from vendor/jameslevi/atmos to root directory.
3. Create a new folder named commands in your root directory.

Getting Started
---------------

[](#getting-started)

1. Generate a new command file.

```
php atmos --make Test

```

2. Open the generated PHP command file and write your code inside the main method.

```
/**
 * Method to be executed in the command line.
 *
 * @param  array $arguments
 * @return void
 */
protected function main(array $arguments)
{
    Console::log("Hello World!");
}
```

3. Test the command.

```
php atmos test

```

Call Specific Methods
---------------------

[](#call-specific-methods)

1. Add new protected method in your command file. For this example let's say "generate".

```
/**
 * This method will generate new file.
 *
 * @param  array $arguments
 * @return void
 */
protected function generate(array $arguments)
{
    Console::success("File is generated.");
}
```

2. Call this method using this command.

```
php atmos test:generate

```

Arguments
---------

[](#arguments)

1. You can use parameters supplied from the command line.

```
/**
 * This method will generate new file.
 *
 * @param  array $arguments
 * @return void
 */
protected function generate(array $arguments)
{
    Console::success($arguments[0] . " file is generated.");
}
```

2. You can call this method using this command.

```
php atmos test:generate newfile.php
```

Alias
-----

[](#alias)

You can set an alias for your command by setting a protected variable named *"alias"* in the command class.

```
protected $alias = "alternative";
```

The command below will execute generate method.

```
php atmos --alternative:generate

```

Console Messages
----------------

[](#console-messages)

1. **Log** - Print a simple message.

```
Console::log("Hello World!");
```

2. **Success** - Print a success message.

```
Console::success("Congratulations! you made it!");
```

3. **Error** - Print an error message.

```
Console::error("Something went wrong!");
```

4. **Info** - Print an info message.

```
Console::info("You scored 30 points!");
```

5. **Warning** - Print a warning message.

```
Console::warn("I told you not to go here!");
```

Call Multiple Commands
----------------------

[](#call-multiple-commands)

Very useful if you want to call multiple commands in just a single command. The order of execution of each command depends on the order of values in array.

```
Console::call(array(
    'composer -h',
    'php atmos -h'
));
```

Start Built-in PHP Server
-------------------------

[](#start-built-in-php-server)

You can now start PHP server using atmos commands. This command will start the server at port 8080.

```
php atmos --serve 8080

```

Contribution
------------

[](#contribution)

For issues, concerns and suggestions, you can email James Crisostomo via .

License
-------

[](#license)

This package is an open-sourced software licensed under [MIT](https://opensource.org/licenses/MIT) License.

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~5 days

Total

6

Last Release

1840d ago

PHP version history (2 changes)v1.0.0-betaPHP >=5.2.0

v1.0.0PHP >=5.3.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/457281?v=4)[Mario](/maintainers/voyager)[@voyager](https://github.com/voyager)

---

Top Contributors

[![jameslevi](https://avatars.githubusercontent.com/u/50510108?v=4)](https://github.com/jameslevi "jameslevi (44 commits)")

---

Tags

clicommand-lineconsolephpcliconsole

### Embed Badge

![Health badge](/badges/jameslevi-atmos/health.svg)

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

###  Alternatives

[symfony/console

Eases the creation of beautiful and testable command line interfaces

9.8k1.1B11.3k](/packages/symfony-console)[nunomaduro/collision

Cli error handling for console/command-line PHP applications.

4.6k331.8M8.5k](/packages/nunomaduro-collision)[nunomaduro/termwind

It's like Tailwind CSS, but for the console.

2.5k239.8M286](/packages/nunomaduro-termwind)[wp-cli/php-cli-tools

Console utilities for PHP

68325.0M367](/packages/wp-cli-php-cli-tools)[php-school/cli-menu

A command line menu helper in PHP

2.0k1.1M27](/packages/php-school-cli-menu)[seld/cli-prompt

Allows you to prompt for user input on the command line, and optionally hide the characters they type

24725.8M17](/packages/seld-cli-prompt)

PHPackages © 2026

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