8.11.0

Changed

• GitHub Copilot migrated to AGENTS.md

  • GitHub Copilot agent configuration now uses AGENTS.md (shared with Codex and OpenCode) instead of .github/copilot-instructions.md
  • Follows the Agents.md standard now supported by GitHub Copilot
  • Provides a single source of truth for Copilot, Codex, and OpenCode agents
  • Existing .github/copilot-instructions.md files are not removed automatically; run coldbox ai refresh to write the updated location

• AI Directory Structure Standardized

  • Renamed /.ai/ directory to /.agents/ to follow BoxLang skill repository conventions
  • All generated agent configurations, guidelines, and skills now use /.agents/ instead of /.ai/
  • Updated all internal code paths, CLI commands, and documentation to reference /.agents/
  • Ensures consistency with the .agents/skills/ directory naming used in BoxLang ecosystem

Added

• Auto-Install Module Skills on Refresh

  • When a module is added to box.json, coldbox ai refresh now automatically detects and installs its corresponding skill from the registry
  • Mirrors the existing MCP server auto-detection behavior — ensures skills and servers are always in sync with project dependencies

• Auto-Recovery of Missing Skills

  • coldbox ai refresh now detects and reinstalls any missing core skills (boxlang, coldbox, testbox, commandbox) that may have been lost
  • Previously, if a skill failed to reinstall, it would be removed from the manifest permanently; now it will be recovered on the next refresh

• Improved coldbox ai skills install --list Command

  • The --list flag now accepts an optional slug parameter to pre-filter the interactive skill list
  • Examples:
    • coldbox ai skills install --list → show all available skills
    • coldbox ai skills install --list coldbox/skills → show only ColdBox skills
    • coldbox ai skills install --list coldbox/skills/coldbox-testing → show only testing category skills

• .mcp.json Support

  • New file in project root to track registered MCP documentation servers for AI integration
  • Updated coldbox ai mcp commands to read/write from this file for consistent MCP server management
  • MCP server entries include name, url, description, and source (core, module, custom)
  • MCP servers registered via coldbox ai mcp add are now saved to .mcp.json in addition to the manifest for AI agent access

• MCP Server Auto-Detection

  • During coldbox ai refresh, the CLI now auto-detects MCP documentation servers from installed modules and updates both the manifest and .mcp.json with any new servers found

• ColdBox MCP Server Support

  • New coldbox ai mcp install command to install the cbMCP module and register it as a custom MCP server in the manifest and .mcp.json. The cbMCP module exposes your running ColdBox application as a live MCP server at http://<host>:<port>/cbmcp, allowing AI agents to introspect your routes, handlers, and models in real time. Supports --host, --port, and --force flags.

• Pretty print saving of manifest on installation

Changed

• Reduced agent file size

  • Core ColdBox/BoxLang guidelines are no longer inlined in generated agent files. Guidelines are stored locally in .ai/guidelines/core/ and referenced via read_file instructions — reducing generated agent files from ~1,000 lines to ~250 lines

• Skills inventory grouped by category

  • Skills in agent files are now organized by prefix (ColdBox, BoxLang, TestBox, CommandBox, etc.) with 80-character truncated descriptions for faster agent scanning

• Cleaner project documentation section

  • The user-editable section in generated agent files now shows 3 focused TODO comment lines instead of 8 empty placeholder headings

• Core guideline files slimmed

  • Full implementation examples removed from coldbox.md, boxlang.md, and cfml.md — each now ends with a skills-reference note directing agents to implementation-detail skills

• Post-install project context reminder

  • coldbox ai install now prominently reminds users to add their project context (business domain, key services, auth, API endpoints, etc.) to the generated agent file

8.10.1

Fixed

• Corruption of box.json on build process overlapping

8.10.0

Added

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

8.9.0

Updates

• CLAUDE.md now contains @AGENTS.md to point Claude to the shared AGENTS.md file, avoiding duplicate content

Fixed

• Fix fwreinit not recognizing webroot setting in server.json
• Fixes for invalid commands in readmes and ai guideline.
• Updated html helper guideline to reflect the new helper syntax and added more examples.

8.8.0

• Fix invalid aliases

8.7.0

v8.7.0

Latest Release v8.7.0

8.6.0

v8.6.0

Latest Release v8.6.0

8.5.0

Added

• New ColdBox ASCII art banner when creating apps and using the app-wizard
• Improved readme and help commands
• Name question in app-wizard if not provided
• Install bx-compat-cfml when doing --rest due to needing some CFML compatibility

AI Integration - Complete System

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

Core Commands

• coldbox ai install - Set up AI integration with agent selection and language detection
• coldbox ai refresh - Sync guidelines, skills, and MCP servers with installed modules
• coldbox ai info - Display current AI configuration
• coldbox ai doctor - Diagnose AI integration health with detailed reporting

Guidelines System (41 Total)

• Core Guidelines (10): boxlang, cfml, coldbox, coldbox-cli, cachebox, wirebox, logbox, testbox, testbox-cli, docbox
• Security & Auth (6): cbsecurity, cbauth, cbsecurity-passkeys, cbsso, cbcsrf, cbantisamy
• Validation & Data (6): cbvalidation, cbi18n, cbmailservices, cbmessagebox, cbpaginator, cbfeeds
• ORM & Database (4): cborm, qb, quick, cfmigrations
• API & Integration (5): hyper, cbproxies, cbswagger, cbelasticsearch, s3sdk
• Utility & Development (8): cbdebugger, cbfs, cbstorages, stachebox, cbjavaloader, cbmarkdown, cbmockdata, docbox
• Modern Development (6): cbwire, cbq, socketbox, mementifier, unleashsdk, cbplaywright
• Additional (7): bcrypt, cors, rulebox, commandbox-migrations, commandbox-boxlang, route-visualizer, relax
• Guidelines commands: list, add, remove, create, override, refresh, help

Skills System (62 Total)

• 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
• 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
• Testing (8): testing-bdd, testing-unit, testing-integration, testing-handler, testing-mocking, testing-fixtures, testing-coverage, testing-ci
• Internal Libraries (3): cachebox-caching-patterns, logbox-logging-patterns, wirebox-di-patterns
• Security (9): security-implementation, authentication, authorization, sso-integration, jwt-development, passkeys-integration, csrf-protection, api-authentication, rbac-patterns
• ORM & Database (5): cborm, qb (query-builder), orm-quick, boxlang-queries, database-migrations
• Modern Development (1): cbwire-development
• Skills commands: list, create, override, refresh, remove, help

MCP Server Integration (30+ Servers)

• Core Servers (7): boxlang, coldbox, commandbox, testbox, wirebox, cachebox, logbox - always included
• 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
• Auto-detection from box.json dependencies with zero configuration
• Custom MCP server support for company/internal documentation
• MCP commands: list, add, remove, help

Multi-Agent Support (6 Agents)

• Supported Agents: Claude (CLAUDE.md), GitHub Copilot (.github/copilot-instructions.md), Cursor (.cursorrules), Codex (AGENTS.md), Gemini (GEMINI.md), OpenCode (AGENTS.md)
• Layout-specific templates (modern, flat)
• Project context detection (Vite, Docker, ORM, Migrations)
• Agents commands: list, add, remove, active, open

Override System

• Guidelines Override: coldbox ai guidelines override <name> - Customize any guideline with project-specific conventions
• Skills Override: coldbox ai skills override <name> - Override core/module skills with project-specific patterns
• Override files stored in .ai/guidelines/overrides/ and .ai/skills/overrides/
• List commands show overrides separately with 🎯 icon
• Remove commands support --override flag for targeted removal
• Template-based override creation (copies original + adds override header)
• Priority system: override > core/module

Module Integration

• Zero-config auto-discovery from box.json dependencies
• Module creation with --ai flag creates .ai/guidelines and .ai/skills directories
• Three-tier guideline fallback: module-shipped → bundled templates → auto-generated
• Auto-registers MCP servers for installed modules
• Path consistency: always uses .ai/ convention (not resources/)

Language Support

• BoxLang and CFML project detection
• Hybrid project support
• Language-specific skill variants
• Code generation respects project language choice

8.4.0

What's Changed

• WIP - API Install tweaks by @gpickin in #27

New Contributors

• @gpickin made their first contribution in #27

Full Changelog: v8.3.0...v8.4.0

8.3.0

What's Changed

• Bump actions/upload-artifact from 4 to 5 by @dependabot[bot] in #23
• Bump actions/download-artifact from 5 to 6 by @dependabot[bot] in #24
• Bump stefanzweifel/git-auto-commit-action from 6 to 7 by @dependabot[bot] in #22
• Bump actions/checkout from 5 to 6 by @dependabot[bot] in #25

Full Changelog: v8.2.0...v8.3.0