larapire / laris
A supercharged Laravel development CLI tool for faster workflow
Requires
- php: ^8.2
- illuminate/filesystem: ^10.20|^11.0|^12.0
- illuminate/support: ^10.20|^11.0|^12.0
- laravel/prompts: ^0.1.18|^0.2.0|^0.3.0
- symfony/console: ^6.2|^7.0
- symfony/polyfill-mbstring: ^1.31
- symfony/process: ^6.2|^7.0
Requires (Dev)
- phpunit/phpunit: ^12.1
- squizlabs/php_codesniffer: ^3.7
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
| Command | What It Does (Because Youโre Too Lazy to Guess) |
|---|---|
laris list |
Lists all commands (duh) |
laris select |
Switch between Laravel projects like a boss |
laris db list-tables |
Shows all DB tables (so you can judge them) |
laris db select users |
Runs SELECT * FROM users (but fancier) |
laris db fake-data |
Fill your DB with beautiful lies (seeding) |
laris backup run |
Backs up your project (before you break it) |
laris deploy |
Deploys with one keystroke (no excuses now) |
laris git push |
Pushes to Git without typing the whole thing |
laris npm run dev |
Runs npm because frontend is hard |
laris docs generate |
Generates docs (so you donโt have to) |
๐ 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
- Navigate to a Laravel project (or use
laris selectto pick one). - 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!
- Profit. ๐ฐ
๐ง AI-Powered Generators
All AI-based commands follow this structure:
php laris laris:ai:make:{component}
Examples:
php laris laris:ai:make:controller php laris laris:ai:make:model php laris laris:ai:make:request php laris laris:ai:make:factory php laris laris:ai:make:migration php 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:
php laris laris:ai:generate:module
๐ Documentation Commands
Generate documentation and readme files easily:
php laris laris:ai:generate:docs php laris laris:ai:generate:readme
โ Test Generation
Automatically create test classes for your existing code:
php laris laris:ai:generate:test
๐ง Refactor Classes
Refactor any PHP class using AI (SOLID, PSR-12, clean code):
php laris laris:ai:refactor:class
๐ง Configuring AI
Before using AI commands, set your OpenRouter key:
php 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)
- Fork it
- Add a cool feature
- Submit a PR
- 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. ๐ค๐ฌ