PHPackages codinglabsau/cody - 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. [Utility & Helpers](/categories/utility) 4. / 5. codinglabsau/cody AbandonedArchivedLibrary[Utility & Helpers](/categories/utility) codinglabsau/cody ================= Cody Agent orchestrates and runs AI workflows on a Laravel app. 01.7kPHPCI passing Since Dec 15Pushed 5mo agoCompare [ Source](https://github.com/codinglabsau/cody)[ Packagist](https://packagist.org/packages/codinglabsau/cody)[ RSS](/packages/codinglabsau-cody/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) Cody orchestrates and runs AI workflows in Laravel ================================================== [](#cody-orchestrates-and-runs-ai-workflows-in-laravel) [![Latest Version on Packagist](https://camo.githubusercontent.com/8ea9160270dc94935febd17400a9671af17ded0fe6334c1c1d8b6971a7925484/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636f64696e676c61627361752f636f64792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/codinglabsau/cody)[![GitHub Tests Action Status](https://camo.githubusercontent.com/f03f71f4a35a9724cb3f7a17fd41b36070d3a8240fb00ce73a9b472562b2b5d0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636f64696e676c61627361752f636f64792f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/codinglabsau/cody/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/8a74b1a47008a11d5cd3437cb0bff462cdadb46ef4b6cfd54115d3e6e144125d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636f64696e676c61627361752f636f64792f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/codinglabsau/cody/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/7c0844812e315992d4c94aedb53e283b42d0b4b55df6f1b4ee5f4e79b17c5faf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636f64696e676c61627361752f636f64792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/codinglabsau/cody) Cody is an AI Agent that allows you to run AI workflows on-demand, or on a schedule that you define, right inside your Laravel app. Features -------- [](#features) - Enscapsulate the project AI strategy using prompts defined in simple YAML files - Manage git worktrees in your local environment through simple artisan commands - PRs submitted automatically to GitHub with AI-generated summaries - Workflows can be invoked on-demand or scheduled as recurring background tasks Installation ------------ [](#installation) You can install the package via composer: ``` composer require codinglabsau/cody ``` In addition to the package, the following commands can be run as required: ``` # dependencies npm install -g @openai/codex brew install gh # authenticate with codex codex login # authenticate with GitHub gh auth login # authenticate with Linear codex mcp add --url https://mcp.linear.app/mcp linear codex mcp login linear -c experimental_use_rmcp_client=true ``` The project `composer.json` should include a Cody setup script, which is executed on git worktrees to get the branch ready for agent workflows. For example: ``` { "scripts": { "ai": [ "composer install", "@php -r \"file_exists('.env') || copy('.env.example', '.env');\"", "@php artisan key:generate", "@php artisan boost:update", "npm ci" ] } } ``` You can publish the config file with: ``` php artisan vendor:publish --tag="cody-config" ``` This is the contents of the published config file: ``` return [ 'scheduler' => [ 'enabled' => env('CODY_SCHEDULER_ENABLED', true), 'timezone' => env('CODY_TIMEZONE', 'UTC'), ], ]; ``` Usage ----- [](#usage) There are two main ways to use Cody Agent; on-demand, or by creating reusable prompts with optional scheduling. ### On-demand [](#on-demand) Coding can be invoked with `php artisan cody --prompt=''`. For example: ``` php artisan cody migrate-to-wayfinder --prompt='Switch from ziggy.js to Laravel Wayfinder. Update all references.' ``` This command will: 1. Create a new git worktree at `../-migrate-to-wayfinder` 2. Call `composer ai` script on the worktree 3. Call Codex CLI with the prompt to complete the task 4. Again call Codex to create a succint commit message and PR description 5. Commit, push, and create a PR on GitHub using the PR template (when available) ### Reusable Prompts [](#reusable-prompts) Reusable prompts can be created by running `php artisan cody:prompt`. This command will ask for all required inputs and output a YAML file to `.ai/prompts/.yaml`. If you have defined prompts that you want to run on a schedule, you can run `php atisan cody:run` to have them run at the scheduled time. Note the `scheduler.timezone` configuration item; if your local PHP timezone is set to UTC, and you set the schedule in local time, you'll want to set the config item to match your local timezone to ensure the scheduler runs at the correct time. Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Create an issue to notify us of any security vulnerabilities. Credits ------- [](#credits) - [stevethomas](https://github.com/stevethomas) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 22 — LowBetter than 22% of packages Maintenance50 Moderate activity, may be stable Popularity15 Limited adoption so far Community6 Small or concentrated contributor base Maturity12 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/6324d6d1a5b089cfa3d7519b590f0762281ff3bad210c6139209a1c6394d6f5c?d=identicon)[stevethomas](/maintainers/stevethomas) --- Top Contributors [![stevethomas](https://avatars.githubusercontent.com/u/1127412?v=4)](https://github.com/stevethomas "stevethomas (66 commits)") ### Embed Badge ![Health badge](/badges/codinglabsau-cody/health.svg) ``` [![Health](https://phpackages.com/badges/codinglabsau-cody/health.svg)](https://phpackages.com/packages/codinglabsau-cody) ``` ### Alternatives [igorw/event-source A PHP 5.3 library for creating an EventSource stream. 10488.7k2](/packages/igorw-event-source)[5balloons/laravel-smart-ads Ad, Banners, Callouts Manager for Laravel 3178.8k](/packages/5balloons-laravel-smart-ads)[jonom/silverstripe-share-care Social media sharing previews and customisation for Silverstripe 2932.7k1](/packages/jonom-silverstripe-share-care) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)