README

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

What the Heck is Laris?

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.

Why Laris is the GOAT (Greatest Of All Time)

• 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.

Laris in Action: The Cheat Sheet

Installation: Get Laris in 3 Seconds

Option 1: The "I’m in a Hurry" Method

composer require larapire/laris

Option 2: The "I’m in a Hurry" Method

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

Option 3: The "I Like Aliases" Method

Add this to your .bashrc or .zshrc:

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

Option 4: The "I Want Global Access" Method

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.

Usage: How to Not Screw It Up

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.

AI-Powered Generators

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.

Full Module Generation

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

~> laris laris:ai:generate:module

Documentation Commands

Generate documentation and readme files easily:

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

Test Generation

Automatically create test classes for your existing code:

~> laris laris:ai:generate:test

Refactor Classes

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

~> laris laris:ai:refactor:class

Performance Monitoring

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

Configuring AI

Before using AI commands, set your OpenRouter key:

~> laris laris:ai:config

For Nerds Who Love Code

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/.

Contribute (Because Sharing is Caring)

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

License

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

Final Words

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