PHPackages                             eaperezc/blacksmith - 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. eaperezc/blacksmith

ActiveLibrary

eaperezc/blacksmith
===================

A CLI command structure for your php processes

v0.0.1(9y ago)2202[3 issues](https://github.com/eaperezc/blacksmith/issues)MITPHP

Since Dec 11Pushed 9y ago3 watchersCompare

[ Source](https://github.com/eaperezc/blacksmith)[ Packagist](https://packagist.org/packages/eaperezc/blacksmith)[ RSS](/packages/eaperezc-blacksmith/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (1)Dependencies (1)Versions (1)Used By (0)

Blacksmith
==========

[](#blacksmith)

![CircleCI](https://camo.githubusercontent.com/5caf07d196872fa1fd23aac2ed9c5ac67f69a313537547db49b8ae5bc0a2829f/68747470733a2f2f696d672e736869656c64732e696f2f636972636c6563692f70726f6a6563742f6769746875622f6561706572657a632f626c61636b736d6974682e7376673f7374796c653d666c61742d737175617265)

To see the full documentation of the library please go to: [Blacksmith Documentation Page](https://eaperezc.github.io/blacksmith/)

PHP Command Line Interface helper library

This library is intended to help developer to create easily CLI commands using php. It is based on the laravel artisan command but totally independent from it.

This is how the terminal looks when you run:

```
php blacksmith help

```

[![Alt text](/resources/sc_blacksmith_help.png?raw=true "Blacksmith Help")](/resources/sc_blacksmith_help.png?raw=true)

Creating a Command
------------------

[](#creating-a-command)

To create a new command, just run:

```
php blacksmith make:cmd hooray
```

This will create a file in `your-project/commands/Hooray.php`. If the `/commands` directory does not yet exist at the time of creating your first command, Blacksmith will automatically generate it for you.

### Organizing Commands

[](#organizing-commands)

We recommend organizing your commands into subdirectories to keep better track of which command does what. Fortunately, this is easy to do with Blacksmith. To generate a command into a subdirectory just provide the desired path you would like the command to reside in:

```
php blacksmith make:cmd path/to/hooray
```

This will generate a file in the following location:

```
your-project/commands/path/to/Hooray.php

```

Even if the subdirectories you specified don't exist, they will be created automatically by Blacksmith. The ending path node `hooray` is considered the command and is where you'll be able to add your command logic.

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 69.7% 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

Unknown

Total

1

Last Release

3442d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fae53973404aad1b553624506052155297c319d554acb44cae8a3bd2e2e1bcf8?d=identicon)[eaperezc](/maintainers/eaperezc)

---

Top Contributors

[![eaperezc](https://avatars.githubusercontent.com/u/739642?v=4)](https://github.com/eaperezc "eaperezc (23 commits)")[![grahamsutton](https://avatars.githubusercontent.com/u/7832785?v=4)](https://github.com/grahamsutton "grahamsutton (10 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/eaperezc-blacksmith/health.svg)

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

PHPackages © 2026

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