_____            _____                    _____                    _____                    _____          
         /\    \          /\    \                  /\    \                  /\    \                  /\    \         
        /::\____\        /::\    \                /::\    \                /::\    \                /::\    \        
       /:::/    /       /::::\    \              /::::\    \               \:::\    \              /::::\    \       
      /:::/    /       /::::::\    \            /::::::\    \               \:::\    \            /::::::\    \      
     /:::/    /       /:::/\:::\    \          /:::/\:::\    \               \:::\    \          /:::/\:::\    \     
    /:::/    /       /:::/__\:::\    \        /:::/__\:::\    \               \:::\    \        /:::/__\:::\    \    
   /:::/    /       /::::\   \:::\    \      /::::\   \:::\    \              /::::\    \       \:::\   \:::\    \   
  /:::/    /       /::::::\   \:::\    \    /::::::\   \:::\    \    ____    /::::::\    \    ___\:::\   \:::\    \  
 /:::/    /       /:::/\:::\   \:::\    \  /:::/\:::\   \:::\____\  /\   \  /:::/\:::\    \  /\   \:::\   \:::\    \ 
/:::/____/       /:::/  \:::\   \:::\____\/:::/  \:::\   \:::|    |/::\   \/:::/  \:::\____\/::\   \:::\   \:::\____\
\:::\    \       \::/    \:::\  /:::/    /\::/   |::::\  /:::|____|\:::\  /:::/    \::/    /\:::\   \:::\   \::/    /
 \:::\    \       \/____/ \:::\/:::/    /  \/____|:::::\/:::/    /  \:::\/:::/    / \/____/  \:::\   \:::\   \/____/ 
  \:::\    \               \::::::/    /         |:::::::::/    /    \::::::/    /            \:::\   \:::\    \     
   \:::\    \               \::::/    /          |::|\::::/    /      \::::/____/              \:::\   \:::\____\    
    \:::\    \              /:::/    /           |::| \::/____/        \:::\    \               \:::\  /:::/    /    
     \:::\    \            /:::/    /            |::|  ~|               \:::\    \               \:::\/:::/    /     
      \:::\    \          /:::/    /             |::|   |                \:::\    \               \::::::/    /      
       \:::\____\        /:::/    /              \::|   |                 \:::\____\               \::::/    /       
        \::/    /        \::/    /                \:|   |                  \::/    /                \::/    /        
         \/____/          \/____/                  \|___|                   \/____/                  \/____/         
                                                                                                                     

Laris is not just another CLI tool—it’s your Laravel Artisan on steroids.

Tired of typing php artisan a million times a day?
Annoyed by forgetting command syntax right after you Google it?
Wish you had a smarter, faster, cooler way to manage Laravel projects?

Enter Laris.

It’s like if Artisan had a caffeine overdose and decided to automate your life.

• Shorter Commands – laris instead of php artisan (because laziness = efficiency).
• Project Switching – Jump between Laravel projects like a multitasking wizard.
• Database Magic – Run queries, fake data, and play God with your DB.
• Deploy Like a Pro – One command to push, migrate, and flex.
• Git & Composer Shortcuts – Because typing git push origin main is so 2020.
• Backup & Docs – Automate boring stuff before you forget.
• Extensible AF – Add your own commands and make it yours.

composer require larapire/laris

git@github.com:LaraPire/laris.git  && cd laris  

Add this to your .bashrc or .zshrc:

alias laris='php /path/to/laris/src/Application.php'  

Symlink it to /usr/local/bin (for ultimate power):

ln -s /path/to/laris/src/Application.php /usr/local/bin/laris  

Now just type laris anywhere, anytime.

1. Navigate to a Laravel project (or use laris select to pick one).

2. Run commands like a pro:

   laris db list-tables   # See what’s in your DB  
   laris db fake-data     # Fill it with nonsense  
   laris deploy           # Ship it!  

3. Profit.

All AI-based commands follow this structure:

php laris laris:ai:make:{component}

Examples:

~> laris laris:ai:make:controller
~> laris laris:ai:make:model
~> laris laris:ai:make:request
~> laris laris:ai:make:factory
~> laris laris:ai:make:migration
~> laris laris:ai:make:seeder

Each command will ask questions in your terminal and generate the appropriate Laravel file using OpenRouter AI.

Generate a complete module (Model, Controller, Migration, etc.) using:

~> laris laris:ai:generate:module

Generate documentation and readme files easily:

~> laris laris:ai:generate:docs
~> laris laris:ai:generate:readme

Automatically create test classes for your existing code:

~> laris laris:ai:generate:test

Refactor any PHP class using AI (SOLID, PSR-12, clean code):

~> laris laris:ai:refactor:class

Monitor and analyze your Laravel application's performance with comprehensive metrics:

~> laris laris:performance
~> laris laris:performance --detailed
~> laris laris:performance --database
~> laris laris:performance --memory
~> laris laris:performance --routes
~> laris laris:performance --export=json

The performance command provides:

• Database Query Analysis - Slow queries, N+1 problems, and optimization suggestions
• Memory Usage Monitoring - Peak memory, memory leaks, and optimization tips
• Route Performance - Response times, bottlenecks, and caching recommendations
• System Resource Usage - CPU, disk I/O, and server performance metrics
• Optimization Recommendations - Actionable suggestions to improve your app's performance

Before using AI commands, set your OpenRouter key:

~> laris laris:ai:config

Laris is built with:

• Pure PHP OOP (because we’re not animals)
• Modular Commands in src/Commands/ (add your own!)
• DB Helpers in src/Library/DB/ (SQL without the pain)
• Concerns for Reusable Logic (DRY is life)

Want to add a command? Just drop a new class in src/Commands/.

1. Fork it
2. Add a cool feature
3. Submit a PR
4. Brag about it on Twitter

MIT. Do whatever. Just don’t blame us if your DB explodes.

Laris exists because typing php artisan is a crime against productivity.

Now go automate your workflow, impress your coworkers, and spend more time drinking coffee.

Happy coding!

(P.S. If you break something, just run laris backup run first. You’re welcome.)

Need more details? Check the docs/ folder or yell at us on GitHub