PHPackages                             marceloxp/iartisan - 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. marceloxp/iartisan

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

marceloxp/iartisan
==================

IArtisan — Craft Artisan commands with AI-powered ease

0.2.0(3mo ago)05MITPHPPHP ^8.1

Since Sep 21Pushed 3mo agoCompare

[ Source](https://github.com/marceloxp/iartisan)[ Packagist](https://packagist.org/packages/marceloxp/iartisan)[ RSS](/packages/marceloxp-iartisan/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (8)Versions (6)Used By (0)

IArtisan
========

[](#iartisan)

> Craft Artisan commands with AI-powered ease

[![screenshot](https://raw.githubusercontent.com/marceloxp/iartisan/refs/heads/main/images/illustration.png)](https://raw.githubusercontent.com/marceloxp/iartisan/refs/heads/main/images/illustration.png)

[![Packagist Version](https://camo.githubusercontent.com/72a6a1a356885906c2a7acd191aeeefe3e57e83bfeb47c5f42b1a7f011e3f31f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d617263656c6f78702f696172746973616e)](https://camo.githubusercontent.com/72a6a1a356885906c2a7acd191aeeefe3e57e83bfeb47c5f42b1a7f011e3f31f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d617263656c6f78702f696172746973616e)[![License](https://camo.githubusercontent.com/8e577be5de01c7d22597d4f27370a95988e95e81e6891c73858b54b51b1efd14/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d617263656c6f78702f696172746973616e)](https://camo.githubusercontent.com/8e577be5de01c7d22597d4f27370a95988e95e81e6891c73858b54b51b1efd14/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d617263656c6f78702f696172746973616e)

IArtisan is a command-line tool that uses the Google Gemini API to suggest `php artisan` commands for Laravel and Filament projects from natural language prompts.

---

✨ Features
----------

[](#-features)

- **Natural language prompts**: Describe what you want in plain English and get the exact `php artisan` command.
- **Smart version detection**: Automatically detects Laravel and Filament versions from your `composer.json`.
- **Filament support**: Use `--f3`, `--f4`, `--f5` or `--f=X` to force a specific Filament version.
- **Automatic execution**: If you're inside a Laravel project, you can confirm and run the command directly.
- **Configurable AI model**: Change Gemini model via `config:set`.
- **Clean and simple CLI**.

---

🚀 Installation
--------------

[](#-installation)

1. **Install via Composer** (recommended globally):

    ```
    composer global require marceloxp/iartisan
    ```
2. **Set up your Gemini API key**:

    ```
    export GEMINI_API_KEY=your-api-key-here
    ```

    Or alternatively:

    ```
    export IARTISAN_GEMINI_KEY=your-api-key-here
    ```
3. **Verify installation**:

    ```
    iartisan --help
    ```

---

🛠 Usage
-------

[](#-usage)

### Basic usage

[](#basic-usage)

```
iartisan create a model Post with migration and controller
```

### Forcing Filament version

[](#forcing-filament-version)

```
iartisan --f5 make a filament resource for User
iartisan --f4 create a filament page for dashboard
iartisan --f6 make a filament widget     # future versions supported
```

### Inside a Laravel project (auto-detection)

[](#inside-a-laravel-project-auto-detection)

When a `composer.json` exists in the current directory, IArtisan automatically detects:

- Laravel version
- Filament version (if installed)

You can still override with `--fX` if needed.

### Configuration

[](#configuration)

```
# Set custom Gemini model
iartisan config:set GEMINI_MODEL=gemini-2.5-flash

# Clear configuration
iartisan config:clear gemini_model
```

---

📚 Examples
----------

[](#-examples)

- **Basic Laravel**

    ```
    iartisan create a migration to add status column to users table
    ```
- **Filament 5**

    ```
    iartisan --f5 make a filament resource for Product
    ```
- **Run migrations**

    ```
    iartisan run all pending migrations
    ```

---

📦 Requirements
--------------

[](#-requirements)

- PHP 8.1+
- Composer
- Google Gemini API key
- (Optional) Laravel project for auto-detection and execution

---

🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome! Feel free to fork the repository and submit a pull request. Please follow PSR-12 coding standards.

---

📄 License
---------

[](#-license)

MIT — see [LICENSE](LICENSE).

---

📬 Support
---------

[](#-support)

For issues or feature requests, please open an issue on the [GitHub repository](https://github.com/marceloxp/iartisan).

For questions, contact Marcelo at ****.

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance82

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

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

Total

5

Last Release

95d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6532b50c12b0488b7c647a3b4bb438543ebf2ce5e0e449d859da6e3d3b149b29?d=identicon)[marceloxp](/maintainers/marceloxp)

---

Top Contributors

[![marceloxp](https://avatars.githubusercontent.com/u/2043045?v=4)](https://github.com/marceloxp "marceloxp (11 commits)")

---

Tags

artisanartisan-commandfilamentfilamentphpgemini-aiialaravel

### Embed Badge

![Health badge](/badges/marceloxp-iartisan/health.svg)

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

###  Alternatives

[laravel/framework

The Laravel Framework.

34.8k543.8M20.1k](/packages/laravel-framework)[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.7k38.9k](/packages/matomo-matomo)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

21866.0M1.7k](/packages/drupal-core)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6942.5M420](/packages/drupal-core-recommended)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)

PHPackages © 2026

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