{"data":{"boxJSON":"{\"name\":\"ColdBox CLI\",\"version\":\"8.10.0+27\",\"author\":\"Ortus Solutions, Corp\",\"location\":\"https://downloads.ortussolutions.com/ortussolutions/commandbox-modules/coldbox-cli/8.10.0/coldbox-cli-8.10.0.zip\",\"directory\":\"\",\"createPackageDirectory\":\"true\",\"packageDirectory\":\"\",\"homepage\":\"https://www.ortussolutions.com\",\"documentation\":\"https://coldbox.ortusbooks.com\",\"repository\":{\"type\":\"git\",\"url\":\"https://github.com/coldbox/coldbox-cli\"},\"bugs\":\"https://github.com/coldbox/coldbox-cli/issues\",\"slug\":\"coldbox-cli\",\"shortDescription\":\"The official CLI for the ColdBox Framework\",\"description\":\"\",\"instructions\":\"\",\"changelog\":\"\",\"type\":\"commandbox-modules\",\"keywords\":\"coldbox,cli,mvc,hmvc\",\"private\":\"false\",\"engines\":[{\"type\":\"\",\"version\":\"\"}],\"defaultEngine\":\"\",\"defaultPort\":\"0\",\"projectURL\":\"\",\"license\":[{\"type\":\"Apache2\",\"url\":\"http://www.apache.org/licenses/LICENSE-2.0\"}],\"contributors\":[\"Brad Wood (brad@bradwood.com)\"],\"dependencies\":{\"testbox-cli\":\"*\",\"commandbox-migrations\":\"*\",\"commandbox-boxlang\":\"*\"},\"devDependencies\":{\"commandbox-cfformat\":\"*\",\"commandbox-docbox\":\"*\"},\"installPaths\":{},\"scripts\":{\"build:module\":\"task run taskFile=build/Build.cfc :projectName=`package show slug` :version=`package show version`\",\"build:docs\":\"task run taskFile=build/Build.cfc target=docs :projectName=`package show slug` :version=`package show version`\",\"format\":\"cfformat run commands,models,build,ModuleConfig.cfc ./.cfformat.json --overwrite\",\"format:watch\":\"cfformat watch commands,models,build,ModuleConfig.cfc ./.cfformat.json\",\"format:check\":\"cfformat check commands,models,build,ModuleConfig.cfc ./.cfformat.json\",\"release\":\"recipe build/release.boxr\"},\"ignore\":[\"**/.*\",\"test-harness\",\"/server*.json\"],\"testbox\":{\"runner\":[{\"default\":\"\"}],\"labels\":\"\",\"excludes\":\"\",\"reporter\":\"\",\"bundles\":\"\",\"recurse\":\"true\",\"directory\":\"tests.specs\",\"testBundles\":\"\",\"testSuites\":\"\",\"testSpecs\":\"\",\"verbose\":\"true\",\"watchDelay\":\"500\",\"watchPaths\":\"**.cfc\",\"options\":{}},\"reinitWatchDirectory\":\"\",\"reinitWatchDelay\":\"500\",\"reinitWatchPaths\":\"\"}","isActive":true,"installInstructions":"","publisher":{"name":"Ortus Solutions","username":"ortus","email":"info@ortussolutions.com"},"version":"8.10.0+27","entryVersionID":"8a808df19d568a4f019d76e6b34f01f8","createdDate":"2026-04-10T10:18:45+00:00","installInstructionsFormat":"text","updatedDate":"2026-04-10T10:18:45+00:00","isStable":true,"changelogFormat":"md","changelog":"# Changelog\n\nAll notable changes to this project will be documented in this file.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n* * *\n\n## [Unreleased]\n\n## [8.10.0] - 2026-04-10\n\n### Added\n\n- Automatic app layout detection for code generation commands. The CLI now detects whether the project uses a modern layout (with `app/` and `public/` directories) or a flat layout, and automatically places generated files in the correct location (e.g., `app/models` vs `models`, `app/handlers` vs `handlers`, etc.).\n\n## [8.9.0] - 2026-04-07\n\n### Updates\n\n- `CLAUDE.md` now contains `@AGENTS.md` to point Claude to the shared `AGENTS.md` file, avoiding duplicate content\n\n### Fixed\n\n- Fix fwreinit not recognizing webroot setting in server.json\n- Fixes for invalid commands in readmes and ai guideline.\n- Updated html helper guideline to reflect the new helper syntax and added more examples.\n\n## [8.8.0] - 2026-03-12\n\n- Fix invalid aliases\n\n## [8.7.0] - 2026-03-12\n\n- Command Aliases\n\n## [8.6.0] - 2026-03-10\n\n- readPackageDescriptorRaw() fix\n\n## [8.5.0] - 2026-03-09\n\n### Added\n\n- New ColdBox ASCII art banner when creating apps and using the app-wizard\n- Improved readme and help commands\n- Name question in app-wizard if not provided\n- Install `bx-compat-cfml` when doing `--rest` due to needing some CFML compatibility\n- New help and consistency on all help commands\n\n#### AI Integration - Complete System\n\n**Complete AI-powered development assistant** for ColdBox with 41 guidelines, 62 skills, 30+ MCP documentation servers, and support for 6 AI agents (Claude, Copilot, Cursor, Codex, Gemini, OpenCode).\n\n##### Core Commands\n\n- `coldbox ai install` - Set up AI integration with agent selection and language detection\n- `coldbox ai refresh` - Sync guidelines, skills, and MCP servers with installed modules\n- `coldbox ai info` - Display current AI configuration\n- `coldbox ai doctor` - Diagnose AI integration health with detailed reporting\n\n##### Guidelines System (41 Total)\n\n- **Core Guidelines (10)**: boxlang, cfml, coldbox, coldbox-cli, cachebox, wirebox, logbox, testbox, testbox-cli, docbox\n- **Security & Auth (6)**: cbsecurity, cbauth, cbsecurity-passkeys, cbsso, cbcsrf, cbantisamy\n- **Validation & Data (6)**: cbvalidation, cbi18n, cbmailservices, cbmessagebox, cbpaginator, cbfeeds\n- **ORM & Database (4)**: cborm, qb, quick, cfmigrations\n- **API & Integration (5)**: hyper, cbproxies, cbswagger, cbelasticsearch, s3sdk\n- **Utility & Development (8)**: cbdebugger, cbfs, cbstorages, stachebox, cbjavaloader, cbmarkdown, cbmockdata, docbox\n- **Modern Development (6)**: cbwire, cbq, socketbox, mementifier, unleashsdk, cbplaywright\n- **Additional (7)**: bcrypt, cors, rulebox, commandbox-migrations, commandbox-boxlang, route-visualizer, relax\n- Guidelines commands: `list`, `add`, `remove`, `create`, `override`, `refresh`, `help`\n\n##### Skills System (62 Total)\n\n- **BoxLang Development (21)**: syntax, classes, functions, lambdas, modules, streams, types, interop, scheduled-tasks, futures, http-client, soap-client, executors, jdbc, templating, caching, file-handling, properties, zip, interceptors, sse, components, application\n- **ColdBox Development (12)**: handler-development, rest-api-development, module-development, interceptor-development, layout-development, routing-development, event-model, view-rendering, cache-integration, coldbox-configuration, coldbox-request-context, coldbox-flash-messaging\n- **Testing (8)**: testing-bdd, testing-unit, testing-integration, testing-handler, testing-mocking, testing-fixtures, testing-coverage, testing-ci\n- **Internal Libraries (3)**: cachebox-caching-patterns, logbox-logging-patterns, wirebox-di-patterns\n- **Security (9)**: security-implementation, authentication, authorization, sso-integration, jwt-development, passkeys-integration, csrf-protection, api-authentication, rbac-patterns\n- **ORM & Database (5)**: cborm, qb (query-builder), orm-quick, boxlang-queries, database-migrations\n- **Modern Development (1)**: cbwire-development\n- Skills commands: `list`, `create`, `override`, `refresh`, `remove`, `help`\n\n##### MCP Server Integration (30+ Servers)\n\n- **Core Servers (7)**: boxlang, coldbox, commandbox, testbox, wirebox, cachebox, logbox - always included\n- **Module Servers (23)**: bxorm, cborm, qb, quick, cfmigrations, cbsecurity, cbauth, cbsso, cbvalidation, cbi18n, cbmailservices, cbdebugger, cbelasticsearch, cbfs, cfconfig, cbwire, cbq, megaphone, contentbox, docbox, relax (cbswagger), modern-cfml, boxlang-ide\n- Auto-detection from box.json dependencies with zero configuration\n- Custom MCP server support for company/internal documentation\n- MCP commands: `list`, `add`, `remove`, `help`\n\n##### Multi-Agent Support (6 Agents)\n\n- **Supported Agents**: Claude (`CLAUDE.md`), GitHub Copilot (`.github/copilot-instructions.md`), Cursor (`.cursorrules`), Codex (`AGENTS.md`), Gemini (`GEMINI.md`), OpenCode (`AGENTS.md`)\n- Layout-specific templates (modern, flat)\n- Project context detection (Vite, Docker, ORM, Migrations)\n- Agents commands: `list`, `add`, `remove`, `active`, `open`\n\n##### Override System\n\n- **Guidelines Override**: `coldbox ai guidelines override <name>` - Customize any guideline with project-specific conventions\n- **Skills Override**: `coldbox ai skills override <name>` - Override core/module skills with project-specific patterns\n- Override files stored in `.ai/guidelines/overrides/` and `.ai/skills/overrides/`\n- List commands show overrides separately with \ud83c\udfaf icon\n- Remove commands support `--override` flag for targeted removal\n- Template-based override creation (copies original + adds override header)\n- Priority system: override > core/module\n\n##### Module Integration\n\n- Zero-config auto-discovery from box.json dependencies\n- Module creation with `--ai` flag creates `.ai/guidelines` and `.ai/skills` directories\n- Three-tier guideline fallback: module-shipped → bundled templates → auto-generated\n- Auto-registers MCP servers for installed modules\n- Path consistency: always uses `.ai/` convention (not `resources/`)\n\n##### Language Support\n\n- BoxLang and CFML project detection\n- Hybrid project support\n- Language-specific skill variants\n- Code generation respects project language choice\n\n## [8.4.0] - 2025-12-15\n\n### Added\n\n- Make sure `commandbox-boxlang` is a dependency to detect BoxLang projects\n\n### Fixed\n\n- Creation of `bx` classes when `--boxlang` is used was missing from handler creation\n- App generation install tweaks to avoid path issues by @gpickin\n- Fix on copying files starting with a dot, like `.babelrc` for vite support, which is ignored by default by git ignores.\n\n## [8.3.0] - 2025-12-08\n\n### Added\n\n- More Modern CFML template support\n\n## [8.2.0] - 2025-11-11\n\n### Added\n\n- Missing rest resources for the `boxlang` template\n\n### Fixed\n\n- Cleanup for vite resources only if vite is not selected\n\n## [8.1.0] - 2025-10-22\n\n### Changed\n\n- `docker` argument to create app was supposed to be `false` by default, not `true`\n\n### Fixed\n\n- Docker ignore issues\n- App env sample ignore issues\n\n## [8.0.0] - 2025-10-13\n\n### Added\n\n- Forgot to bump it to match ColdBox version.\n\n## [7.10.0] - 2025-10-10\n\n### Added\n\n- Modules Inherit Entry Point defaults to `true` now\n- Brand new app-wizard for creating apps interactively\n- fix colors for ps screens\n- BoxLang is now the default engine for new apps\n- Updated all new templates from repos\n- New create app argument for modern or boxlang skeletons: `vite` to create a Vite enabled app: `coldbox create app name=\"myApp\" --vite`\n- New create app argument for modern or boxlang skeletons: `rest` to create a REST enabled app: `coldbox create app name=\"myApp\" --rest`\n- - New create app argument for modern or boxlang skeletons: `docker` to create a Docker enabled app: `coldbox create app name=\"myApp\" --docker`\n- New create app argument for modern or boxlang skeletons: `migrations` to create a Migrations enabled app: `coldbox create app name=\"myApp\" --migrations`\n- New `--cfml` argument to create a CFML app: `coldbox create app name=\"myApp\" --cfml` instead of BoxLang (app is default)\n- BoxLang template skeleton rename\n- Updated docs for BoxLang detection\n\n## [7.8.0] - 2025-09-29\n\n### Added\n\n- Copilot instructions for AI coding assistance\n- If the skeleton is `default` and this is a BoxLang project, it will switch the skeleton to `BoxLang`.\n- added dependabot\n- Moved `testbox-cli` and `commandbox-migrations` to dependencies so we can use them in the CLI commands\n\n## [7.7.0] - 2025-04-29\n\n### Fixed\n\n- More fixes for `boxlang` arguments\n\n## [7.6.0] - 2025-04-28\n\n### Added\n\n- New `modern` template for creating modern apps with the latest features\n- New `boxlang` template for creating apps with the latest boxlang features\n- Modernization of all templates to use the latest features of ColdBox\n- New `--boxlang` argument to create content for BoxLang\n- New `language` argument detection for BoxLang\n\n### Changed\n\n- Updated to the latest Ubuntu images for the GitHub actions\n\n### Fixed\n\n- Fixed resource handler creation.\n\n## [7.5.0] - 2024-10-16\n\n### Fixed\n\n- watch reinit issues with `coldbox watch` command\n- key [TEMPLATEPATH] doesn't exist when doing orm operations. This was a typo, it should have been `templatesPath`\n\n## [7.4.0] - 2024-03-20\n\n### Fixed\n\n- Create resources missing `open` param\n\n### Added\n\n- More documentation\n\n## [7.3.0] - 2024-02-12\n\n### Added\n\n- New github actions\n- Lazy load `testbox-cli, commandbox-migrations` only when used.\n\n## [7.2.1] - 2023-05-19\n\n### Fixed\n\n- Fixed `coldbox create layout` failing due to unescpaed `#view()#` command\n\n## [7.2.0] - 2023-05-18\n\n### Added\n\n- New version of CommandBox Migrations\n- Added `testbox-cli` as a dependency\n\n## [7.1.0] - 2023-05-18\n\n### Added\n\n- `BaseCommand` hierarchy for all commands to inherit from\n- New print functions for uniformity of info, warning, success and error messages\n- New `coldbox create service` command to create services easily\n- Create model with migration now actually generates the property migrations\n- Create `coldbox create model --service` to create a model with a service\n- Create `coldbox create model --all` to create a model with a service and all the things\n\n### Fixed\n\n- Version should match major ColdBox version, moved to `7`\n- Fixed `coldbox create app` command to finalize the create app job\n- Set default location to `forgeboxStorage` for new apps, this was missing\n- `coldbox create handler` was not creating the `views`\n- Models `isLoaded()` was actually wrong\n- Handler test specs carriage returns\n- When creating models with rest or resources, the handler was not being created\n\n## [1.0.0] - 2023-05-03\n\n### Added\n\n- Migration from CommandBox core to a separate module\n- Updated all templates to ColdBox 7\n- Updated all `resources` to ColdBox 7 standard code\n- Add `--force` command to several commands for overwriting files\n- Create app new argument: `migrations` to init the migrations on the project: `coldbox create app name=\"myApp\" --migrations`\n- `create view` command now has an `open` attribute to open the created views in the editor\n- You can create layouts with content now: `create layout name=\"myLayout\" content=\"my content\"`\n- You can create views with content now: `create view name=\"myView\" content=\"my content\"`\n- You can create resourceful handlers: `create handler name=\"myHandler\" --resource`\n- You can create resourceful rest handlers: `create handler name=\"myHandler\" --resource --rest`\n- You can create models with migrations now: `create model name=\"myModel\" --migration`\n- You can create models with seeders now: `create model name=\"myModel\" --seeder`\n- You can create models with handlers (normal or rest) now: `create model name=\"myModel\" --handler` or `create model name=\"myModel\" --handler --rest`\n- You can create models with a resource handler now: `create model name=\"myModel\" --resource`\n- You can create models will all the things now: `create model name=\"myModel\" --all`\n- New `coldbox docs` command to open the ColdBox docs in your browser and search as well: `coldbox docs search=\"event handlers\"`\n- New `coldbox apidocs` command to open the ColdBox API Docs in your browser.\n\n### Fixed\n\n- Was resetting the `scripts` in the templates, which is not needed\n\n### Removed\n\n- Eclipse support\n\n[unreleased]: https://github.com/ColdBox/coldbox-cli/compare/v8.10.0...HEAD\n[8.10.0]: https://github.com/ColdBox/coldbox-cli/compare/v8.9.0...v8.10.0\n[8.9.0]: https://github.com/ColdBox/coldbox-cli/compare/v8.8.0...v8.9.0\n[8.8.0]: https://github.com/ColdBox/coldbox-cli/compare/v8.7.0...v8.8.0\n[8.7.0]: https://github.com/ColdBox/coldbox-cli/compare/v8.6.0...v8.7.0\n[8.6.0]: https://github.com/ColdBox/coldbox-cli/compare/v8.5.0...v8.6.0\n[8.5.0]: https://github.com/ColdBox/coldbox-cli/compare/v8.4.0...v8.5.0\n[8.4.0]: https://github.com/ColdBox/coldbox-cli/compare/v8.3.0...v8.4.0\n[8.3.0]: https://github.com/ColdBox/coldbox-cli/compare/v8.2.0...v8.3.0\n[8.2.0]: https://github.com/ColdBox/coldbox-cli/compare/v8.1.0...v8.2.0\n[8.1.0]: https://github.com/ColdBox/coldbox-cli/compare/v8.0.0...v8.1.0\n[8.0.0]: https://github.com/ColdBox/coldbox-cli/compare/v7.10.0...v8.0.0\n[7.10.0]: https://github.com/ColdBox/coldbox-cli/compare/v7.8.0...v7.10.0\n[7.8.0]: https://github.com/ColdBox/coldbox-cli/compare/v7.8.0...v7.8.0\n[7.7.0]: https://github.com/ColdBox/coldbox-cli/compare/v7.6.0...v7.7.0\n[7.6.0]: https://github.com/ColdBox/coldbox-cli/compare/v7.5.0...v7.6.0\n[7.5.0]: https://github.com/ColdBox/coldbox-cli/compare/v7.4.0...v7.5.0\n[7.4.0]: https://github.com/ColdBox/coldbox-cli/compare/v7.3.0...v7.4.0\n[7.3.0]: https://github.com/ColdBox/coldbox-cli/compare/v7.2.1...v7.3.0\n[7.2.1]: https://github.com/ColdBox/coldbox-cli/compare/v7.2.0...v7.2.1\n[7.2.0]: https://github.com/ColdBox/coldbox-cli/compare/v7.1.0...v7.2.0\n[7.1.0]: https://github.com/ColdBox/coldbox-cli/compare/v1.0.0...v7.1.0\n[1.0.0]: https://github.com/ColdBox/coldbox-cli/compare/94e639a1ba9d10c8d9ad663435233bd115cf8586...v1.0.0\n","descriptionFormat":"md","installs":222,"downloadURL":"https://downloads.ortussolutions.com/ortussolutions/commandbox-modules/coldbox-cli/8.10.0/coldbox-cli-8.10.0.zip","binaryHash":"","description":"<p align=\"center\">\n\t<img src=\"https://raw.githubusercontent.com/Ortus-Solutions/ortus-artwork/refs/heads/main/coldbox/SVG/coldbox-logo-full-dark-M.svg\" alt=\"ColdBox Platform Logo\">\n</p>\n\n<p align=\"center\">\n\t<a href=\"https://github.com/coldbox/coldbox-cli/actions/workflows/snapshot.yml\"><img src=\"https://github.com/coldbox/coldbox-cli/actions/workflows/snapshot.yml/badge.svg\" alt=\"ColdBox Snapshots\" /></a>\n\t<a href=\"https://forgebox.io/view/coldbox-cli\"><img src=\"https://forgebox.io/api/v1/entry/coldbox-cli/badges/downloads\" alt=\"Total Downloads\" /></a>\n\t<a href=\"https://forgebox.io/view/coldbox-cli\"><img src=\"https://forgebox.io/api/v1/entry/coldbox-cli/badges/version\" alt=\"Latest Stable Version\" /></a>\n\t<a href=\"https://forgebox.io/view/coldbox-cli\"><img src=\"https://img.shields.io/badge/License-Apache2-brightgreen\" alt=\"Apache2 License\" /></a>\n</p>\n\n<p align=\"center\">\n\tCopyright Since 2005 ColdBox Platform by Luis Majano and Ortus Solutions, Corp\n\t<br>\n\t<a href=\"https://www.coldbox.org\">coldbox.org</a> »\n\t<a href=\"https://www.boxlang.io\">boxlang.io</a> »\n\t<a href=\"https://www.ortussolutions.com\">ortussolutions.com</a>\n</p>\n\n# ColdBox CLI\n\n<img src=\"coldbox-cli.png\" alt=\"ColdBox CLI\" style=\"width:100%; max-width:800px; margin:20px auto; display:block; border-radius:8px; box-shadow:0 4px 12px rgba(0,0,0,0.1);\">\n\nThis is the official ColdBox CLI for CommandBox. It is a collection of commands to help you work with ColdBox and its ecosystem for building, testing, and deploying BoxLang and CFML applications. It provides commands for scaffolding applications, creating tests, modules, models, views, and much more.\n\n## Table of Contents\n\n- [Table of Contents](#table-of-contents)\n- [License](#license)\n- [ColdBox CLI Versions](#coldbox-cli-versions)\n- [Installation](#installation)\n- [Usage](#usage)\n \t- [\ud83d\udcf1 Application Creation](#-application-creation)\n \t\t- [\ud83e\uddd9‍♂️ Interactive App Wizard](#️-interactive-app-wizard)\n \t- [Application Templates](#application-templates)\n \t\t- [\ud83e\udd4a BoxLang Templates (Recommended)](#-boxlang-templates-recommended)\n \t\t- [\ud83d\udcdc Legacy CFML Templates](#-legacy-cfml-templates)\n \t\t- [\ud83d\ude80 Template Features](#-template-features)\n \t\t- [⚡ Vite Integration](#-vite-integration)\n \t\t- [\ud83d\udc33 Docker Integration](#-docker-integration)\n \t- [\ud83c\udfaf Handlers (Controllers)](#-handlers-controllers)\n \t- [\ud83d\udcca Models \\& Services](#-models--services)\n \t- [\ud83c\udfa8 Views \\& Layouts](#-views--layouts)\n \t- [\ud83d\udd27 Resources \\& CRUD](#-resources--crud)\n \t- [\ud83d\udce6 Modules](#-modules)\n \t- [\ud83e\uddea Testing](#-testing)\n \t- [\ud83d\uddc4️ ORM \\& Database](#️-orm--database)\n \t- [\ud83d\udd17 Interceptors](#-interceptors)\n \t- [\ud83d\udd04 Development Workflow](#-development-workflow)\n \t- [\ud83c\udf9b️ Global Options](#️-global-options)\n \t\t- [Application-Specific Flags](#application-specific-flags)\n \t\t- [Language Generation Control](#language-generation-control)\n \t- [\ud83d\udca1 BoxLang Support](#-boxlang-support)\n \t\t- [\ud83d\udd0d Automatic Detection](#-automatic-detection)\n \t\t- [⚙️ Configuration Examples](#️-configuration-examples)\n \t\t\t- [Method 1: Language Property (Recommended)](#method-1-language-property-recommended)\n \t\t\t- [Method 2: TestBox Runner Setting](#method-2-testbox-runner-setting)\n \t\t- [\ud83d\ude80 Usage Examples](#-usage-examples)\n \t\t- [\ud83d\udcdd Generated Code Differences](#-generated-code-differences)\n \t- [\ud83e\udd16 AI Integration](#-ai-integration)\n \t\t- [Setup \\& Management](#setup--management)\n \t\t- [AI Agents](#ai-agents)\n \t\t- [Guidelines](#guidelines)\n \t\t- [Skills](#skills)\n \t\t- [MCP Servers](#mcp-servers)\n \t\t- [AI Context Management](#ai-context-management)\n \t- [\ud83d\udcd6 Getting Help](#-getting-help)\n- [Credits \\& Contributions](#credits--contributions)\n \t- [The Daily Bread](#the-daily-bread)\n\n## License\n\nApache License, Version 2.0.\n\n## ColdBox CLI Versions\n\nThe CLI matches the major version of ColdBox. **Current version: 8**\n\n- If you are using **ColdBox 8**, use CLI `@8` (recommended)\n- If you are using **ColdBox 7**, use CLI `@7.8.0` (recommended)\n\nThis versioning ensures you get the correct commands and features for your version of ColdBox.\n\n## Installation\n\nInstall the commands via CommandBox like so:\n\n```bash\nbox install coldbox-cli\n```\n\n## Usage\n\nThe ColdBox CLI provides powerful scaffolding and development tools for both **CFML** and **BoxLang** applications. All commands support the `--help` flag for detailed information.\n\n### \ud83d\udcf1 Application Creation\n\nCreate new ColdBox applications from various templates. **BoxLang is now the default language** for new applications:\n\n```bash\n# Create a basic ColdBox app (BoxLang by default)\ncoldbox create app myApp\ncoldbox create app myApp --boxlang # Force BoxLang (default)\n\n# Create a CFML app explicitly\ncoldbox create app myApp --cfml\n\n# Create with specific templates\ncoldbox create app myApp skeleton=modern\ncoldbox create app myApp skeleton=rest\ncoldbox create app myApp skeleton=flat\n\n# Create with additional features\ncoldbox create app myApp --migrations # Database migrations support\ncoldbox create app myApp --docker # Docker environment setup\ncoldbox create app myApp --vite # Vite frontend asset building\ncoldbox create app myApp --rest # REST API configuration\n\n# Combine multiple features\ncoldbox create app myApp --migrations --docker --vite\n\n# Interactive app wizard (recommended for beginners)\ncoldbox create app-wizard\n```\n\n#### \ud83e\uddd9‍♂️ Interactive App Wizard\n\nThe `app-wizard` command provides an interactive, step-by-step process for creating new applications. It's perfect for beginners or when you want to explore all available options:\n\n```bash\ncoldbox create app-wizard\n```\n\nThe wizard will guide you through:\n\n1. **Project Location**: Whether to create in current directory or a new folder\n2. **Language Selection**: Choose between BoxLang (default) or CFML\n3. **Project Type**: API/REST service or full web application\n4. **Frontend Setup**: Optional Vite integration for web applications\n5. **Environment**: Optional Docker containerization\n6. **Database**: Optional migrations support\n\n**Example Wizard Flow**:\n\n```\nAre you currently inside the \"myapp\" folder? [y/n]: n\nIs this a BoxLang project? [y/n]: y\nAre you creating an API? [y/n]: n\nWould you like to configure Vite as your Front End UI pipeline? [y/n]: y\nWould you like to setup a Docker environment? [y/n]: y\nAre you going to require Database Migrations? [y/n]: y\n```\n\n### Application Templates\n\nThe CLI supports multiple application templates (skeletons), or you can use your own via any FORGEBOX ID, GitHub repo, local path, zip or URL. **BoxLang templates are now the primary focus** for modern development:\n\n#### \ud83e\udd4a BoxLang Templates (Recommended)\n\n- `boxlang` (default) - A modern ColdBox app using BoxLang as the primary language with latest features\n- `modern` - A modern ColdBox app supporting both BoxLang and CFML with contemporary architecture\n- `rest` - A ColdBox REST API template optimized for BoxLang development\n\n#### \ud83d\udcdc Legacy CFML Templates\n\n- `flat` - A classic ColdBox app with a flat structure for traditional CFML development\n- `rest-hmvc` - A RESTful ColdBox app using HMVC architecture\n- `supersimple` - A bare-bones template for minimal setups\n- `vite` - A ColdBox app integrated with Vite for frontend development (legacy)\n\n#### \ud83d\ude80 Template Features\n\nModern templates (`boxlang`, `modern`) support additional features via flags:\n\n- `--vite` - Integrates Vite for modern frontend asset building and hot reloading\n- `--rest` - Configures the application as a REST API service\n- `--docker` - Includes Docker configuration for containerized development\n- `--migrations` - Sets up database migrations support\n\n#### ⚡ Vite Integration\n\nThe CLI now supports Vite integration for modern frontend development with hot module replacement and optimized builds:\n\n```bash\n# Create app with Vite support\ncoldbox create app myApp --vite\n\n# Available for BoxLang and Modern templates\ncoldbox create app myApp skeleton=modern --vite\n```\n\n**Vite Features Included**:\n\n- Pre-configured `vite.config.mjs` with ColdBox/BoxLang integration\n- Hot module replacement (HMR) for development\n- Optimized production builds with code splitting\n- Asset preprocessing for CSS, SCSS, JavaScript, and TypeScript\n- Development server with proxy configuration\n- Build scripts in `package.json`\n\n**Development Workflow**:\n\n```bash\n# Start development server with hot reloading\nnpm run dev\n\n# Build for production\nnpm run build\n\n# Preview production build\nnpm run preview\n```\n\n#### \ud83d\udc33 Docker Integration\n\nThe CLI provides Docker integration to containerize your ColdBox applications for consistent development and deployment environments:\n\n```bash\n# Create app with Docker support\ncoldbox create app myApp --docker\n\n# Combine with other features\ncoldbox create app myApp --docker --vite --migrations\n```\n\n**Docker Features Included**:\n\n- Multi-stage `Dockerfile` optimized for ColdBox applications\n- `docker-compose.yml` for local development with services\n- Database service configuration (PostgreSQL/MySQL)\n- Redis caching service setup\n- Environment variable configuration\n- Production-ready container optimization\n- Health checks and monitoring setup\n\n**Docker Commands**:\n\n```bash\n# Build and start development environment\ndocker-compose up -d\n\n# View logs\ndocker-compose logs -f\n\n# Stop services\ndocker-compose down\n\n# Rebuild containers\ndocker-compose up --build\n```\n\n### \ud83c\udfaf Handlers (Controllers)\n\nGenerate MVC handlers with actions and optional views:\n\n```bash\n# Basic handler\ncoldbox create handler myHandler\n\n# Handler with specific actions\ncoldbox create handler users index,show,edit,delete\n\n# REST handler\ncoldbox create handler api/users --rest\n\n# Resourceful handler (full CRUD)\ncoldbox create handler photos --resource\n\n# Generate with views and tests\ncoldbox create handler users --views --integrationTests\n```\n\n### \ud83d\udcca Models & Services\n\nCreate domain models and business services:\n\n```bash\n# Basic model\ncoldbox create model User\n\n# Model with properties and accessors\ncoldbox create model User properties=fname,lname,email --accessors\n\n# Model with migration\ncoldbox create model User --migration\n\n# Model with service\ncoldbox create model User --service\n\n# Model with everything (service, handler, migration, seeder)\ncoldbox create model User --all\n\n# Standalone service\ncoldbox create service UserService\n```\n\n### \ud83c\udfa8 Views & Layouts\n\nGenerate view templates and layouts:\n\n```bash\n# Create a view\ncoldbox create view users/index\n\n# View with helper file\ncoldbox create view users/show --helper\n\n# View with content\ncoldbox create view welcome content=\"<h1>Welcome!</h1>\"\n\n# Create layout\ncoldbox create layout main\n\n# Layout with content\ncoldbox create layout admin content=\"<cfoutput>#view()#</cfoutput>\"\n```\n\n### \ud83d\udd27 Resources & CRUD\n\nGenerate complete resourceful components:\n\n```bash\n# Single resource (handler, model, views, routes)\ncoldbox create resource photos\n\n# Multiple resources\ncoldbox create resource photos,users,categories\n\n# Custom handler name\ncoldbox create resource photos PhotoGallery\n\n# With specific features\ncoldbox create resource users --tests --migration\n```\n\n### \ud83d\udce6 Modules\n\nCreate reusable ColdBox modules:\n\n```bash\n# Create module\ncoldbox create module myModule\n\n# Module with specific features\ncoldbox create module myModule --models --handlers --views\n```\n\n### \ud83e\uddea Testing\n\nGenerate various types of tests:\n\n```bash\n# Unit tests\ncoldbox create unit models.UserTest\n\n# BDD specs\ncoldbox create bdd UserServiceTest\n\n# Integration tests\ncoldbox create integration-test handlers.UsersTest\n\n# Model tests\ncoldbox create model-test User\n\n# Interceptor tests\ncoldbox create interceptor-test Security --actions=preProcess,postProcess\n```\n\n### \ud83d\uddc4️ ORM & Database\n\nWork with ORM entities and database operations:\n\n```bash\n# ORM Entity\ncoldbox create orm-entity User table=users\n\n# ORM Service\ncoldbox create orm-service UserService entity=User\n\n# Virtual Entity Service\ncoldbox create orm-virtual-service UserService\n\n# ORM Event Handler\ncoldbox create orm-event-handler\n\n# CRUD operations\ncoldbox create orm-crud User\n```\n\n### \ud83d\udd17 Interceptors\n\nCreate AOP interceptors:\n\n```bash\n# Basic interceptor\ncoldbox create interceptor Security\n\n# Interceptor with specific interception points\ncoldbox create interceptor Logger points=preProcess,postProcess\n\n# With tests\ncoldbox create interceptor Security --tests\n```\n\n### \ud83d\udd04 Development Workflow\n\nManage your development environment:\n\n```bash\n# Reinitialize ColdBox framework\ncoldbox reinit\n\n# Auto-reinit on file changes\ncoldbox watch-reinit\n\n# Open documentation\ncoldbox docs\ncoldbox docs search=\"event handlers\"\n\n# Open API documentation\ncoldbox apidocs\n```\n\n### \ud83c\udf9b️ Global Options\n\nMost commands support these common options:\n\n- `--force` - Overwrite existing files without prompting\n- `--open` - Open generated files in your default editor\n- `--boxlang` - Force BoxLang code generation (usually not needed as it's the default)\n- `--cfml` - Force CFML code generation (overrides BoxLang default)\n- `--help` - Show detailed help for any command\n\n#### Application-Specific Flags\n\nFor application creation commands:\n\n- `--migrations` - Include database migrations support\n- `--docker` - Include Docker configuration and containerization\n- `--vite` - Include Vite frontend asset building (modern/BoxLang templates)\n- `--rest` - Configure as REST API application (BoxLang templates)\n\n#### Language Generation Control\n\nThe CLI supports both automatic detection and manual override of the target language. **BoxLang is now the default language** for all new applications and generated code:\n\n- **Default**: BoxLang code generation for new applications and components\n- **Automatic**: Uses detection methods (server engine, `box.json` settings) for existing projects\n- **Force CFML**: Use `--cfml` flag to generate CFML code regardless of detection\n- **Force BoxLang**: Use `--boxlang` flag to explicitly generate BoxLang code (usually not needed as it's the default)\n\n### \ud83d\udca1 BoxLang Support\n\nThe CLI automatically detects BoxLang projects and generates appropriate code. You can also force BoxLang mode using the `--boxlang` flag.\n\n#### \ud83d\udd0d Automatic Detection\n\nThe CLI detects BoxLang projects using three methods (in order of precedence):\n\n1. **Server Engine Detection**: Running on a BoxLang server\n2. **TestBox Runner Setting**: When `testbox.runner` is set to `\"boxlang\"` in `box.json`\n3. **Language Property**: When `language` is set to `\"boxlang\"` in `box.json`\n\n#### ⚙️ Configuration Examples\n\n##### Method 1: Language Property (Recommended)\n\n```json\n{\n \"name\": \"My BoxLang App\",\n \"language\": \"boxlang\",\n \"testbox\": {\n \"runner\": \"/tests/runner.bxm\"\n }\n}\n```\n\n##### Method 2: TestBox Runner Setting\n\n```json\n{\n \"name\": \"My App\",\n \"testbox\": {\n \"runner\": \"boxlang\"\n }\n}\n```\n\n### \ud83d\uddc2️ App Layout Detection\n\nThe CLI automatically detects whether your project uses a **modern** or **flat** layout and generates files in the correct location.\n\n| Layout | Detection | App Code Location | Tests Location |\n| ------ | --------- | ----------------- | -------------- |\n| **Modern** | Both `app/` and `public/` directories exist | `/app/models`, `/app/handlers`, etc. | `/tests/` |\n| **Flat** | Default (no `app/` + `public/`) | `/models`, `/handlers`, etc. | `/tests/` |\n\n#### Modern Layout (e.g. `boxlang`, `modern` templates)\n\n```text\n/app - Application source code\n /config - Configuration\n /handlers - Event handlers\n /models - Models & services\n /views - View templates\n /layouts - Layout wrappers\n /interceptors - Interceptors\n/public - Web root\n/modules - ColdBox modules\n/tests - Test suites\n/resources - Migrations, seeders, etc.\n```\n\n#### Flat Layout (e.g. `flat`, legacy templates)\n\n```text\n/config - Configuration\n/handlers - Event handlers\n/models - Models & services\n/views - View templates\n/layouts - Layout wrappers\n/interceptors - Interceptors\n/modules - ColdBox modules\n/tests - Test suites\n```\n\nWhen you run a generation command in a modern-layout project, the CLI automatically targets the correct directory:\n\n```bash\n# In a flat layout project → creates /handlers/users.cfc\n# In a modern layout project → creates /app/handlers/users.cfc\ncoldbox create handler users\n\n# In a flat layout project → creates /models/User.cfc\n# In a modern layout project → creates /app/models/User.cfc\ncoldbox create model User\n```\n\nYou can always override the target directory explicitly:\n\n```bash\ncoldbox create model User directory=app/models\n```\n\n#### \ud83d\ude80 Usage Examples\n\n```bash\n# Default behavior (creates BoxLang code)\ncoldbox create handler users\ncoldbox create model User\n\n# Explicit BoxLang generation (usually not needed)\ncoldbox create handler users --boxlang\n\n# Force CFML generation for legacy projects\ncoldbox create handler users --cfml\ncoldbox create app myApp --cfml\n```\n\n#### \ud83d\udcdd Generated Code Differences\n\nWhen BoxLang mode is detected or forced:\n\n- Uses `.bx` file extensions instead of `.cfc`\n- Generates `class` syntax instead of `component`\n- Uses BoxLang-specific template variants\n- Creates BoxLang test files (`.bxm` extensions)\n\n### \ud83e\udd16 AI Integration\n\nThe ColdBox CLI provides a comprehensive AI integration system that enhances your development workflow with intelligent coding assistance. This includes guidelines, skills, agent configurations, and MCP (Model Context Protocol) servers.\n\n#### Setup & Management\n\n```bash\n# Install AI integration\ncoldbox ai install # Interactive setup\ncoldbox ai install agent=claude # Setup with specific agent\n\n# View current configuration\ncoldbox ai info # Show configuration summary\ncoldbox ai tree # Visual hierarchy of AI components\ncoldbox ai stats # Context usage and statistics\ncoldbox ai stats --verbose # Detailed breakdown with model utilization\n\n# Sync with installed modules\ncoldbox ai refresh # Update guidelines and skills\n\n# Diagnose issues\ncoldbox ai doctor # Check AI integration health\n```\n\n#### AI Agents\n\nConfigure AI assistants for your project (Claude, GitHub Copilot, Cursor, etc.):\n\n```bash\n# Manage agents\ncoldbox ai agents list # List available agents\ncoldbox ai agents add claude copilot # Add multiple agents\ncoldbox ai agents remove cursor # Remove an agent\ncoldbox ai agents refresh # Regenerate all configurations\n```\n\n**Supported Agents**: Claude (CLAUDE.md → AGENTS.md), GitHub Copilot (.github/copilot-instructions.md), Cursor (.cursorrules), Codex (AGENTS.md), Gemini (GEMINI.md), OpenCode (AGENTS.md)\n\n#### Guidelines\n\nFramework documentation and best practices for AI assistants:\n\n```bash\n# View guidelines\ncoldbox ai guidelines list # List all installed guidelines\ncoldbox ai guidelines list --verbose # Show details and descriptions\n\n# Manage guidelines\ncoldbox ai guidelines add coldbox testbox # Install by name\ncoldbox ai guidelines add https://example.com/ # Install from URL\ncoldbox ai guidelines remove testbox # Remove guideline\ncoldbox ai guidelines refresh # Update from modules\n```\n\n**Guideline Types**: Core (framework), Module (from installed modules), Custom (project-specific), Override (custom versions of core)\n\n#### Skills\n\nAI coding cookbooks with practical how-to examples:\n\n```bash\n# View skills\ncoldbox ai skills list # List all installed skills\ncoldbox ai skills list --verbose # Show details\n\n# Manage skills\ncoldbox ai skills add creating-handlers async-programming\ncoldbox ai skills remove async-programming\ncoldbox ai skills refresh # Update from modules\n```\n\n**Skill Categories**: Scaffolding, Testing, Configuration, Database, REST APIs, Security, Performance, and more\n\n#### MCP Servers\n\nModel Context Protocol documentation servers:\n\n```bash\n# View MCP configuration\ncoldbox ai mcp list # List available servers\ncoldbox ai mcp info # Show configuration\n\n# Manage servers\ncoldbox ai mcp add github filesystem # Add MCP servers\ncoldbox ai mcp remove filesystem # Remove a server\ncoldbox ai mcp config # Generate agent-specific configs\n```\n\n**MCP Server Types**: Core (30+ built-in), Module (from packages), Custom (project-specific)\n\n#### AI Context Management\n\n**Subagent Pattern**: ColdBox CLI uses an optimized architecture that reduces context by 58% while maintaining full capability:\n\n- **Core Guidelines Inlined** (~20KB): ColdBox framework + language always embedded in agent files\n- **Resource Inventories** (~13KB): Module guidelines and skills listed with descriptions for on-demand loading\n- **Total Base Context**: ~33KB / ~8,400 tokens (down from ~62KB / ~15,000+ tokens)\n\nThe CLI tracks and analyzes your AI context usage:\n\n- **Context Estimation**: Calculates total KB and token usage\n- **Usage Indicators**: Shows Low/Moderate/High/Very High warnings\n- **Model Compatibility**: Displays utilization for Claude, GPT-4, GPT-3.5-Turbo, Gemini\n- **Optimization Tips**: Monitors context efficiency with the subagent pattern\n\n```bash\ncoldbox ai stats # Quick overview\ncoldbox ai stats --verbose # Full analysis with model breakdowns\ncoldbox ai stats --json # Machine-readable output\n```\n\n### \ud83d\udcd6 Getting Help\n\nEvery command provides detailed help:\n\n```bash\n# General help\ncoldbox help\n\n# AI integration help\ncoldbox ai help\n\n# Specific command help\ncoldbox create handler --help\ncoldbox ai agents --help\ncoldbox ai stats --help\n```\n\n## Credits & Contributions\n\nI THANK GOD FOR HIS WISDOM IN THIS PROJECT\n\n### The Daily Bread\n\n\"I am the way, and the truth, and the life; no one comes to the Father, but by me (JESUS)\" Jn 14:1-12\n","sortOrder":47},"error":false,"pagination":{},"messages":[]}