laravelgpt
Version:
CLI tools for AI agents
337 lines (251 loc) β’ 15.7 kB
Markdown
<<<<<<< HEAD
# LaravelGPT
LaravelGPT is a CLI tool that allows you to interact with AI models and other tools. It is optimized for Cursor Composer Agent but it can be used by any coding agent that can execute commands.
## Quick Links
| Topic | Description |
|-------|-------------|
| Essential information to understand what laravelgpt is and how to get started using it | [](https://lmpify.com?q=https%3A%2F%2Fuuithub.com%2Feastlondoner%2Fcursor-tools%2Ftree%2Fmain%3FpathPatterns%3DREADME.md%26pathPatterns%3DCONFIGURATION.md%26pathPatterns%3Dpackage.json%26pathPatterns%3Dlaravelgpt.config.json%26pathPatterns%3D.cursor-tools.env.example%26pathPatterns%3Dsrc%252Fvibe-rules.ts%0A%0AI'm%20new%20to%20laravelgpt.%20Can%20you%20explain%20what%20it%20is%2C%20how%20to%20install%20it%2C%20and%20how%20to%20get%20started%20with%20basic%20commands%3F) |
| What commands are available in laravelgpt and what does each one do? | [](https://lmpify.com?q=https%3A%2F%2Fuuithub.com%2Feastlondoner%2Fcursor-tools%2Ftree%2Fmain%3FpathPatterns%3DREADME.md%26pathPatterns%3DCONFIGURATION.md%26pathPatterns%3Dpackage.json%26pathPatterns%3Dlaravelgpt.config.json%26pathPatterns%3D.cursor-tools.env.example%26pathPatterns%3Dsrc%252Fvibe-rules.ts%0A%0AWhat%20commands%20are%20available%20in%20laravelgpt%20and%20what%20does%20each%20one%20do%3F) |
| How do I use the browser commands in laravelgpt? What browser automation capabilities are available? | [](https://lmpify.com?q=https%3A%2F%2Fuuithub.com%2Feastlondoner%2Fcursor-tools%2Ftree%2Fmain%3FpathPatterns%3DREADME.md%26pathPatterns%3DCONFIGURATION.md%26pathPatterns%3Dpackage.json%26pathPatterns%3Dlaravelgpt.config.json%26pathPatterns%3D.cursor-tools.env.example%26pathPatterns%3Dsrc%252Fvibe-rules.ts%0A%0AHow%20do%20I%20use%20the%20browser%20commands%20in%20laravelgpt%3F%20What%20browser%20automation%20capabilities%20are%20available%3F) |
| How do I use different LLM providers with laravelgpt? What providers are supported? | [](https://lmpify.com?q=https%3A%2F%2Fuuithub.com%2Feastlondoner%2Fcursor-tools%2Ftree%2Fmain%3FpathPatterns%3DREADME.md%26pathPatterns%3DCONFIGURATION.md%26pathPatterns%3Dpackage.json%26pathPatterns%3Dlaravelgpt.config.json%26pathPatterns%3D.cursor-tools.env.example%26pathPatterns%3Dsrc%252Fvibe-rules.ts%0A%0AHow%20do%20I%20use%20different%20LLM%20providers%20with%20laravelgpt%3F%20What%20providers%20are%20supported%3F) |
| How do I use the MCP commands in laravelgpt? What is MCP and how does it work? | [](https://lmpify.com?q=https%3A%2F%2Fuuithub.com%2Feastlondoner%2Fcursor-tools%2Ftree%2Fmain%3FpathPatterns%3DREADME.md%26pathPatterns%3DCONFIGURATION.md%26pathPatterns%3Dpackage.json%26pathPatterns%3Dlaravelgpt.config.json%26pathPatterns%3D.cursor-tools.env.example%26pathPatterns%3Dsrc%252Fvibe-rules.ts%0A%0AHow%20do%20I%20use%20the%20MCP%20commands%20in%20laravelgpt%3F%20What%20is%20MCP%20and%20how%20does%20it%20work%3F) |
| How do I use the testing capabilities in laravelgpt? How can I create and run tests? | [](https://lmpify.com?q=https%3A%2F%2Fuuithub.com%2Feastlondoner%2Fcursor-tools%2Ftree%2Fmain%3FpathPatterns%3DREADME.md%26pathPatterns%3DCONFIGURATION.md%26pathPatterns%3Dpackage.json%26pathPatterns%3Dlaravelgpt.config.json%26pathPatterns%3D.cursor-tools.env.example%26pathPatterns%3Dsrc%252Fvibe-rules.ts%0A%0AHow%20do%20I%20use%20the%20testing%20capabilities%20in%20laravelgpt%3F%20How%20can%20I%20create%20and%20run%20tests%3F) |
| How do I configure laravelgpt? What configuration options are available? | [](https://lmpify.com?q=https%3A%2F%2Fuuithub.com%2Feastlondoner%2Fcursor-tools%2Ftree%2Fmain%3FpathPatterns%3DREADME.md%26pathPatterns%3DCONFIGURATION.md%26pathPatterns%3Dpackage.json%26pathPatterns%3Dlaravelgpt.config.json%26pathPatterns%3D.cursor-tools.env.example%26pathPatterns%3Dsrc%252Fvibe-rules.ts%0A%0AHow%20do%20I%20configure%20laravelgpt%3F%20What%20configuration%20options%20are%20available%3F) |
| How does telemetry work in laravelgpt? What data is collected and how is it used? | [](https://lmpify.com?q=https%3A%2F%2Fuuithub.com%2Feastlondoner%2Fcursor-tools%2Ftree%2Fmain%3FpathPatterns%3DREADME.md%26pathPatterns%3DCONFIGURATION.md%26pathPatterns%3Dpackage.json%26pathPatterns%3Dlaravelgpt.config.json%26pathPatterns%3D.cursor-tools.env.example%26pathPatterns%3Dsrc%252Fvibe-rules.ts%0A%0AHow%20does%20telemetry%20work%20in%20laravelgpt%3F%20What%20data%20is%20collected%20and%20how%20is%20it%20used%3F) |
| What are some examples of how to use laravelgpt commands effectively? | [](https://lmpify.com?q=https%3A%2F%2Fuuithub.com%2Feastlondoner%2Fcursor-tools%2Ftree%2Fmain%3FpathPatterns%3DREADME.md%26pathPatterns%3DCONFIGURATION.md%26pathPatterns%3Dpackage.json%26pathPatterns%3Dlaravelgpt.config.json%26pathPatterns%3D.cursor-tools.env.example%26pathPatterns%3Dsrc%252Fvibe-rules.ts%0A%0AWhat%20are%20some%20examples%20of%20how%20to%20use%20laravelgpt%20commands%20effectively%3F) |
## Table of Contents
- [Installation](#installation)
- [Configuration](#configuration)
- [laravelgpt.config.json](#laravelgptconfigjson)
- [Environment Variables](#environment-variables)
- [IDE Integration](#ide-integration)
- [Commands](#commands)
- [laravelgpt cli](#laravelgpt-cli)
- [Documentation Command](#documentation-command)
- [Browser Commands](#browser-commands)
- [MCP Commands](#mcp-commands)
- [Testing Commands](#testing-commands)
- [Development](#development)
- [Contributing](#contributing)
- [License](#license)
## Installation
```bash
npm install -g laravelgpt
```
## Configuration
### laravelgpt.config.json
Customize `laravelgpt` behavior by creating a `laravelgpt.config.json` file. This file can be created either globally in `~/.laravelgpt/laravelgpt.config.json` or locally in your project root.
The laravelgpt.config file configures the local default behaviour for each command and provider.
Here is an example of a typical laravelgpt.config.json file, showing some of the most common configuration options:
```json
{
// Commands
"repo": {
"provider": "openrouter",
"model": "google/gemini-2.5-pro-preview"
},
"doc": {
"provider": "openrouter",
"model": "anthropic/claude-sonnet-4",
"maxTokens": 4096
},
"web": {
"provider": "gemini",
"model": "gemini-2.5-pro-preview"
},
"plan": {
"fileProvider": "gemini",
"thinkingProvider": "perplexity",
"thinkingModel": "r1-1776"
},
"browser": {
"headless": false
},
//...
// Providers
"stagehand": {
"model": "claude-sonnet-4-20250514", // For Anthropic provider
"provider": "anthropic", // or "openai"
"timeout": 90000
},
"openai": {
"model": "gpt-4o"
}
//...
}
```
For details of all configuration options, see [CONFIGURATION.md](CONFIGURATION.md). This includes details of all the configuration options and how to use them.
### Environment Variables
Set the following environment variables to configure `laravelgpt`:
- `PERPLEXITY_API_KEY`: Your Perplexity API key
- `GEMINI_API_KEY`: Your Google Gemini API key
- `OPENAI_API_KEY`: Your OpenAI API key (optional, for Stagehand)
- `ANTHROPIC_API_KEY`: Your Anthropic API key (optional, for Stagehand and MCP)
- `OPENROUTER_API_KEY`: Your OpenRouter API key (optional, for MCP)
- `XAI_API_KEY`: Your xAI Grok API key (optional, for xAI models)
- `GITHUB_TOKEN`: Your GitHub token (optional, for enhanced GitHub access)
### IDE Integration
`laravelgpt` integrates with various IDEs and environments. Ensure your project is set up to use `laravelgpt` correctly.
## Commands
### laravelgpt cli
Execute commands using:
```bash
laravelgpt <command> [options]
```
For example:
```bash
laravelgpt web "What's new in TypeScript 5.7?"
```
### Documentation Command
Generate comprehensive documentation for repositories:
```bash
laravelgpt doc [options]
```
Options:
- `--from-github <url>`: GitHub repository URL to document
- `--subdir <path>`: Subdirectory to focus on
- `--with-doc <url>`: Additional document to include for context
- `--format <format>`: Output format (markdown, json, html)
- `--output <path>`: Save output to specified file
- `--provider <name>`: AI provider to use
- `--model <name>`: Model to use
- `--max-tokens <number>`: Maximum tokens to use
- `--hint <text>`: Additional hint for documentation
- `--debug`: Enable debug mode
- `--quiet`: Suppress progress output
- `--save-to <path>`: Save output to file
Examples:
```bash
# Generate documentation for current repository
laravelgpt doc
# Generate documentation for GitHub repository
laravelgpt doc --from-github https://github.com/username/repo
# Generate documentation with specific format
laravelgpt doc --format json
# Save documentation to file
laravelgpt doc --output docs/README.md
# Generate documentation with multiple options
laravelgpt doc --format html --output docs/index.html --provider gemini
```
### Browser Commands
Automate browser interactions for web scraping, testing, and debugging:
```bash
# Open a URL and capture page content
laravelgpt browser open "https://example.com" --html
# Take a screenshot
laravelgpt browser open "https://example.com" --screenshot=page.png
# Debug in an interactive browser session
laravelgpt browser open "https://example.com" --connect-to=9222
```
### MCP Commands
Access multiple AI models through a unified API:
```bash
# Use OpenRouter for MCP commands
laravelgpt mcp "Explain the authentication flow in this project, which files are involved?"
```
### Testing Commands
Use the testing framework to create and run tests:
```bash
# Run tests in the current directory
laravelgpt test
# Run tests in a specific directory
laravelgpt test --dir=tests/unit
```
## Development
`laravelgpt` is designed to be used with Cursor Composer Agent but it can be used by any coding agent that can execute commands. Ensure your project is set up to use `laravelgpt` correctly.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request. If you used `laravelgpt` to make your contribution please include screenshots or videos of `laravelgpt` in action.
## License
MIT License - see [LICENSE](LICENSE) for details.
=======
# π MD Shamim Hossain β aka `Script Coder`
π **Full-Stack Developer** | π€ **AI & OSINT Automation Architect** | π **Mobile Unlock Specialist**
π΄ **Founder of Red Hackers** | π₯ **Reverse Engineer** | π¦ **Malware & Virus Analyst**
π‘ **Telegram Bot Developer** | π **PHP ionCube Decoder Specialist** | π **Data Scraping Expert**
---
## π§ About Me
I'm a passionate developer bridging **software engineering**, **AI**, **offensive security**, and **mobile technology**. I create tools that **automate**, **secure**, and **unlock potential** in the digital world. From **Laravel SaaS platforms** and **Telegram bots** to **UFSTool-based mobile unlock systems** and **ionCube decryption tools**, my work pushes boundaries while prioritizing ethical use.
As the founder of **Red Hackers**, I lead research in:
- **AI-Driven Malware Analysis** & Botnet Simulations
- **OSINT & MegaLeak Tracking**
- **Mobile IMEI/FRP Unlock Tools**
- **PHP ionCube Decoder Development**
- **Telegram Automation & Data Scraping**
---
## π§° My Arsenal
### π» Web Development (SaaS + Secure)
- **Laravel 10β12**, Livewire, Tailwind, Vue, Alpine.js
- **Dhru Fusion API** for IMEI/Remote Unlock SaaS
- Role-based dashboards (Admin, Seller, User)
### π Mobile Unlock & Repair Tools
- **UFSTool-based Scripts**: IMEI, FRP, SIM, Network Unlock
- **ADB/Fastboot Automation**: Flash, modem patching, bootloop fixes
- **Supported Brands**: Samsung, Xiaomi, Huawei, Vivo, Oppo
### π€ Telegram Bot Development
- Multi-purpose bots with:
- File upload/download, encryption, and obfuscation
- IMEI service panels & real-time alerts
- Auto-scraping for messages, users, and channels
### π§² OSINT & Scraping
- Email/IP/Phone/Dark Web recon bots
- Telegram-integrated data harvesting
- Automated breach detection & alert systems
### π PHP Botnet & Security Tools
- **ionCube Loader Decoder** (PHP-based, educational use)
- **Botnet Panels** for red team simulations (VM-only)
- Encrypted C2 communication via PHP sockets
### π₯οΈ Desktop Apps
- **Python**: Tkinter, PyQt5, CustomTkinter
- **C#/VB.NET**: GUI tools, obfuscators, and simulators
- Key projects: Telegram GUIs, file encryptors, TeraBox downloaders
### π€ AI & LLM Integrations
- **OpenAI, Claude, Gemini**: Text, image, code generation
- Laravel-based GPT SaaS platforms
### π Reverse Engineering & Malware Analysis
- **ionCube Decoder** for PHP script analysis (ethical use only)
- CrackMe solvers, IDA, x64dbg, Ghidra
- Malware behavior analysis (keyloggers, RATs, trojans)
---
## π§ Featured Projects
| Tool | Description |
|------|-------------|
| **ionCube PHP Decoder** | Decodes ionCube-encrypted PHP files for analysis (Educational) |
| **Python ionCube Decoder** | Python-based tool for ionCube file inspection |
| **IMEI Sync Pro** | Laravel + Dhru API SaaS for mobile unlocking |
| **LeakHunter** | Telegram + Web dashboard for breach tracking |
| **RedBot** | Telegram bot with scraping, file ops, and automation |
| **UFSTool Pro** | Python + Batch tool for mobile unlock/repair |
| **TeraBox Downloader GUI** | Python desktop app for file fetching |
---
## 𧬠Tech Stack
**Languages**: PHP, Python, JavaScript, C++, C#, VB.NET, SQL, Bash
**Frameworks**: Laravel, Tailwind, PyQt, Tkinter, Vue, WinForms
**AI Models**: GPT-4.5, Claude, Gemini, SDXL, Whisper
**Security Tools**: IDA, Ghidra, Radare2, Wireshark, PEStudio
**Bot Tools**: Pyrogram, Telethon, PHP Sockets, Telegram Bot API
**Mobile Tools**: UFSTool, ADB, Fastboot, Dhru API
---
## π Live Projects
- [Laravel IMEI Panel + Dhru](https://github.com/laravelgpt)
- [TeraBox Downloader GUI](https://github.com/laravelgpt/terabox-downloader-desktop-gui)
- [Telegram Account Deleter](https://github.com/laravelgpt/telegram-account-delete-desktop-application-python)
- **ionCube Decoder Suite** (Private, Request Access)
- **RedBot Telegram System** (Private)
---
## π― Upcoming Projects
- **Web Crawler for MegaLeaks**
- **Telegram LLM Assistant** with file AI capabilities
- **RedHackerShell**: Terminal for tool/script execution
- **PHP ionCube Decoder Public Edition** (Educational VM-only)
- **Laravel Breach Engine** with API tracking
---
## π Connect with Me
- π **GitHub**: [github.com/laravelgpt](https://github.com/laravelgpt)
- π‘ **Telegram**: `@ComingSoon`
- π **Website**: Coming Soon
- π **Facebook**: [facebook.com/shamimdevs](https://facebook.com/shamimdevs)
---
> π§ **βCode the unseen. Automate the unknown. Unlock the impossible.β**
> β *Script Coder* / Red Hackers Founder
> -π§ Nothing is impossible β everything is possible. Hacking is not just skill, it's magic.
>>>>>>> 77fec43f9dccc2412824d2a180f7bec954ec2c69