PHPackages                             grahamsutt12/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. [CLI & Console](/categories/cli)
4. /
5. grahamsutt12/blacksmith

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

grahamsutt12/blacksmith
=======================

A CLI command structure for your php processes

v0.0.1(9y ago)039MITPHP

Since Dec 11Pushed 9y ago1 watchersCompare

[ Source](https://github.com/grahamsutt12/blacksmith)[ Packagist](https://packagist.org/packages/grahamsutt12/blacksmith)[ RSS](/packages/grahamsutt12-blacksmith/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (1)Versions (2)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

25

—

LowBetter than 36% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

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

3488d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2e1337f95ca37721e90ed0b9e42b8e0c277d3b96a5caaa6c5a2dd85167953cc1?d=identicon)[grahamsutt12](/maintainers/grahamsutt12)

---

Top Contributors

[![eaperezc](https://avatars.githubusercontent.com/u/739642?v=4)](https://github.com/eaperezc "eaperezc (22 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/grahamsutt12-blacksmith/health.svg)

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

###  Alternatives

[seld/cli-prompt

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

24726.4M22](/packages/seld-cli-prompt)[illuminate/console

The Illuminate Console package.

13045.3M6.2k](/packages/illuminate-console)[styleci/cli

The CLI tool for StyleCI

71464.1k9](/packages/styleci-cli)[winbox/args

Windows command-line formatter

20718.9k21](/packages/winbox-args)

PHPackages © 2026

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