NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1806 most downloaded on Packagist
AI development assistant CLI for Symfony projects
Latest stable
v0.15.0
Last release 27 days ago
26 Oct 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 15 of 15 stable releases
Nothing withdrawn
no release was ever pulled
11 months old
16 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
minor #2823 Prep Release v1.0-BETA1 (@chr-hertel)
Changelog (https://github.com/symfony/ai-mate/compare/v0.15.0...v1.0.0-BETA1)
minor #2753 Bump version constraints to 0.15 (@chr-hertel)
Changelog (https://github.com/symfony/ai-mate/compare/v0.14.0...v0.15.0)
minor #2599 Bump version to 0.14 and sync demo Mate skills (@chr-hertel)
Changelog (https://github.com/symfony/ai-mate/compare/v0.13.0...v0.14.0)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Arguments column to tools:list's table output, and stop truncating tool descriptions to 50 characters, so a tool's parameters and full description are visible without a separate tools:inspect calltools:inspect <tool-name> hint to tools:call's error output when a parameter name is unknown or a required one is missingskills:install output (same columns as skills:list, plus an action column showing installed/rebuilt/skipped/unchanged), and --format=json/--format=toon support, matching skills:listtools:call: when the effective format is pretty (the default, or explicitly requested) and the result's compact JSON encoding exceeds 8 KB, render it as json instead and print a note explaining why, since renderPretty() folds a large nested value onto a single unreadable line; --format=json/--format=toon are unaffectedtools:call's --format=pretty rendering to print one unpadded key: value line per result field instead of SymfonyStyle::definitionList(), which padded every value to the width of the widest one in the list, inflating small/medium results with whitespace alone (a representative real result rendered ~5x smaller after this change, with no information loss)minor #2460 Bump Version Constraints for v0.13.0 (@chr-hertel)
Changelog (https://github.com/symfony/ai-mate/compare/v0.12.0...v0.13.0)
limit (@wachterjohannes)Encoding\ResponseEncoder::encodeUntrusted(), wrapping a payload under an untrusted_data key alongside a _security_notice, so tool responses carrying data captured from the inspected application are explicitly marked as data rather than instructions.agents/skills/mate-<name>/ (rewriting the frontmatter name to the installed name) with relative .claude/skills/ mirror symlinks, instead of symlinking into vendor/; the mirror falls back to a copy where symlinks are unavailableskills:install into an idempotent reconciler that rebuilds both generated folders from source or user override on every run and prunes skills of removed or disabled extensions; discover runs it automaticallymate/extensions.php: the user-editable enabled and mode (managed|override) plus the machine-managed state, source, source_hash, hash and targetsskills:list command: a read-only diagnostic listing declared and installed skills with their enabled/mode/state/status (including stale and broken detection)skills:validate command: checks the generated folders against the recorded state and fails on hand-edited content, missing folders or a mispointed mirror (--strict also fails on warnings)skills:prune command: removes generated mate-* folders that no longer belong to any skill (--dry-run to preview)skills:override and skills:reset commands: take ownership of a skill by copying it into mate/skills/<name>/, and hand it back to Mate again--dry-run to skills:install, reporting what the run would install, rebuild or remove without writing anythingskills:validate: a warning when SKILL.md links to a file that is not part of the installed skill (failing --strict like any other warning), and suggestions when a description is shorter than 40 characters or never says when the skill applies (printed only, never changing the exit code, not even with --strict)skills:disable and skills:enable commands: flip enabled for a single skill and rebuild or remove its generated foldersCLAUDE.md in the project root to mate init/mate discover that imports AGENTS.md via @AGENTS.md, so Claude Code discovers the Mate CLI instructions it would otherwise never readmcp/sdk, the serve and stop commands and the MCP runtime are gone, and mate init writes CLI-oriented agent instructions instead of mcp.json/.mcp.json and the Codex wrappers. Tools and resources are discovered by reflection from the native #[MateTool], #[MateResource] and #[MateResourceTemplate] attributes in Symfony\AI\Mate\Attribute; prompts have no native equivalent and are removed along with debug:capabilities --type=promptmcp:tools:*/mcp:resources:read to tools:list, tools:inspect, tools:call and resources:read, and change tools:call to take tool parameters as long options (tools:call symfony-profiler-list --limit=1, repeated for variadic parameters) with --json for nested values, replacing the positional JSON argumentmate.invocation and mate.php_version to mate/config.php: mate init asks how the coding agent should invoke Mate (defaulting to ddev exec vendor/bin/mate when a .ddev/ directory is present), materializes that command into the agent instructions, pins mate.php_version by running php through that wrapper (falling back to the current process and warning when it cannot be probed), and Mate refuses to start under a different PHP major.minor (init, discover, list, help and completion warn instead of refusing)minor #2358 Prepare version constraints for release of v0.12.0 (@chr-hertel)
Changelog (https://github.com/symfony/ai-mate/compare/v0.11.0...v0.12.0)
skills:install command and extra.ai-mate.skills config key to install Agent Skills shipped by extensions into .agents/skills and .claude/skills for coding agentsminor #2320 Prepare version constraints for release of v0.11.0 (@chr-hertel)
Changelog (https://github.com/symfony/ai-mate/compare/v0.10.0...v0.11.0)
mate init (detects .ddev/ and defaults the generated mcp.json launch command to ddev exec php, otherwise php) so the MCP server can be started from the host for containerized setupsChangelog (https://github.com/symfony/ai-mate/compare/v0.9.0...v0.10.0) * no significant changes
Changelog (https://github.com/symfony/ai-mate/compare/v0.9.0...v0.10.0)
feature #2050 Add logger profiler collector formatter (@wachterjohannes)
Changelog (https://github.com/symfony/ai-mate/compare/v0.8.0...v0.9.0)
--ignore-missing-file option to discover command (@wachterjohannes)tag filter parameter to symfony-services MCP tool to filter services by DI tag name (e.g. kernel.event_listener, twig.extension)channel filter parameter to monolog-tail MCP tool for consistency with monolog-searchTimeCollectorFormatter for the Symfony profiler time collector, exposing request duration, initialization time, and stopwatch events sorted by durationLoggerCollectorFormatter for the Symfony profiler logger collector, exposing error/warning/deprecation/scream counts and individual log entriesMemoryCollectorFormatter for the Symfony profiler memory collector, exposing peak memory usage, memory limit, and usage percentagesymfony-service-detail MCP tool to retrieve full details of a single DI container service by its exact ID (class, tags, method calls, factory)ResourcesReadCommand (mcp:resources:read) to read MCP resources by URI from the CLImate init from App\Mate\ to Mate\ProfilerResourceTemplate and ProfilerTool) to be instantiated without a ProfilerDataProvider, throwing a clear RuntimeException when invoked in workspaces without profiler support--ignore-missing-file option to the discover command that exits successfully without doing any work when mate/extensions.php does not exist (intended for unconditional invocation from Composer scripts wired by the Symfony Flex recipe)json-input argument optional in mcp:tools:call command (defaults to {})Changelog (https://github.com/symfony/ai-mate/compare/v0.7.0...v0.8.0) * no significant changes
Changelog (https://github.com/symfony/ai-mate/compare/v0.7.0...v0.8.0)
feature #1439 Add TOON format encoding for MCP tool responses (@wachterjohannes)
Changelog (https://github.com/symfony/ai-mate/compare/v0.6.0...v0.7.0)
helgesverre/toon) to mcp:tools:list, mcp:tools:inspect, mcp:tools:call, debug:capabilities, debug:extensions to allow token efficient usage in CLIbin/codex, bin/codex.bat) to mate initmate discover (mate/AGENT_INSTRUCTIONS.md and managed AGENTS.md block)php-version, operating-system, operating-system-family, and php-extensions tools into a single server-info toolhelgesverre/toon to enable)feature #1636 Add TranslationCollectorFormatter for Symfony profiler (@wachterjohannes)
Changelog (https://github.com/symfony/ai-mate/compare/v0.5.0...v0.6.0)
TranslationCollectorFormatter for Symfony profiler (@wachterjohannes)MailerCollectorFormatter for Symfony profiler (@wachterjohannes)Changelog (https://github.com/symfony/ai-mate/compare/v0.4.0...v0.5.0) * no significant changes
Changelog (https://github.com/symfony/ai-mate/compare/v0.4.0...v0.5.0)
bug #1603 Fix profiler collector names to use short names (@wachterjohannes)
Changelog (https://github.com/symfony/ai-mate/compare/v0.3.3...v0.4.0)
Add support for instructions field in extension composer.json to provide AI agent guidance
instructions field in extension composer.json to provide AI agent guidanceextension: false flag in extra.ai-mate composer.json configuration to exclude packages from being discovered as extensionsToolsInspectCommand to inspect a specific toolToolsListCommand to list all available toolsToolsCallCommand to call a specific tool with inputAdd StopCommand to stop a running server
StopCommand to stop a running server--force-keep-alive option to ServeCommand to restart server if it was stoppeddebug:capabilities command to display all discovered MCP capabilities grouped by extension* Add component
One column per month.