Patch release that closes a hard blocker for Gemini CLI users: aix mcp add was returning "unsupported platform: gemini" for every invocation because the command handler switch statement was never wired to the completed Gemini platform layer. All users on the Gemini CLI platform were unable to add MCP servers via aix.
- Gemini CLI — mcp add: Wired Gemini CLI into the
mcp addcommand handler. The platform adapter was fully implemented in v0.8.0 but the switch case was absent, causing every call to fall through to an unsupported-platform error. (PR #41 /cb8908f,921bfff)
- Updated
--platformflag help text to includegeminias a valid value. - Added Gemini-specific test coverage for
mcp add. - Routine dependency and CI workflow bumps (color, yaml, picomatch, brace-expansion, actions group).
This release introduces significant updates to the Gemini CLI platform adapter, including TOML configuration support and improved skill installation logic. It also addresses security vulnerabilities and refactors shared installation logic for better maintainability.
- Gemini CLI Updates: Full support for Gemini CLI platform adapter updates.
- TOML Support: Added TOML support for Gemini CLI configuration files.
- Skill Installation Enhancements: All supporting files are now copied during skill installation.
- Refactored Install Logic: Extracted shared installation logic to
internal/installto unify resource management.
- Security: Fixed identified security bugs and performed deep refactoring of platform adapters.
- CopyDir Guard: Added safety checks to
CopyDirto prevent same-path and recursive source-into-destination copies. - Formatting: General file formatting and cleanup.
- Updated dependencies and CI workflows to use latest action versions.
This patch release addresses critical path resolution issues affecting repository resource installation and configuration loading on macOS.
- Resource Installation: Fixed an issue where
aix agent install(and other resource installers) would fail with "no AGENT.md found" by incorrectly looking in temporary directories. Installation now correctly reads directly from the persistent repository cache. - Agent Naming: Improved robustness of agent parsing; if an agent file lacks a
namefield in its frontmatter,aixnow falls back to using the filename. - Config Loading: Fixed configuration discovery on macOS to prioritize
~/.config/aix/config.yamlif it exists, ensuring consistency for users who prefer standard XDG paths over the system default~/Library/Application Support.
- No breaking changes or migration steps required.
This release introduces bulk installation capabilities for all resource types. Users can now install all agents, commands, skills, or MCP servers from a specific repository in a single operation, significantly streamlining the setup process for new environments.
- Bulk Installation: Added the
--all-from-repo <repo-name>flag toaix agent install,aix command install,aix skill install, andaix mcp install. This allows users to install every resource of a given type from a configured repository at once (e.g.,aix skill install --all-from-repo official).
- No breaking changes. Existing installation workflows remain unaffected.
This release introduces an interactive search experience for discovering resources. Users can now launch an fzf-style fuzzy finder directly from the CLI to browse and filter skills, commands, agents, and MCP servers across all repositories.
- Interactive Fuzzy Search: Running
aix searchwithout arguments now launches an interactive, fzf-style fuzzy finder. This interface allows users to filter results in real-time and preview resource details (description, type, repo) before selecting an item. Standard text search (aix search <query>) and filters (--type,--repo) remain fully supported.
- No breaking changes. Existing search workflows remain compatible.
This release standardizes configuration paths on macOS to follow XDG conventions (~/.config/aix, ~/.cache/aix), aligning the developer experience across Linux and macOS. It also improves the resilience of repository tracking and updates the Gemini CLI adapter to match upstream capabilities.
- Standardized macOS Paths:
aixnow defaults to XDG-style paths (~/.config,~/.cache,~/.local/share) on macOS, matching Linux behavior. Legacy paths (~/Library/Application Support) are still supported as a fallback for existing installations.
- Repository Tracking: Fixed an issue where
aix repo addcould fail if the cache directory existed but wasn't tracked, improving robustness against manual filesystem changes. - Gemini CLI Adapter: Removed support for the
{{selection}}variable in the Gemini adapter as it is not supported by the upstream Gemini CLI tool.
- Configuration: macOS users setting up
aixfor the first time will now see config files in~/.config/aixinstead of~/Library/Application Support/aix.
This release focuses on hardening the configuration loading and repository management logic, making aix more robust and predictable. It also includes a key bug fix for Gemini users and several internal refactorings to improve testability and code quality.
- Hardened Configuration Loading: The tool's configuration handling has been made more secure and stable.
aixnow initializes its configuration earlier in the startup process and no longer searches forconfig.yamlin the current working directory, preventing unexpected behavior during development. - Robust Repository Management: The repository manager is now more resilient to missing configuration files and ensures key data structures are always initialized, preventing potential panics.
- Gemini Platform: A bug has been fixed where multiline instructions in skill prompts were incorrectly serialized into single-line strings in the generated TOML command files, breaking their execution.
- Refactoring: Several parts of the codebase, including repository command handling and table-driven tests, have been refactored to improve testability, readability, and maintainability.
- Documentation: The
AGENTS.mdguide has been updated with a mandatory workflow for completing work sessions to ensure no work is left behind.
Released: 2026-01-24
This release adds Gemini CLI platform support to aix, completing platform parity for skill and command installation across Claude Code, OpenCode, and Gemini CLI. It also includes a bug fix for Gemini variable translation and improvements to test coverage and documentation.
-
Gemini CLI platform support — The
aix command installandaix skill installcommands now support targeting Gemini CLI (--platform gemini), enabling configuration management across all three major AI coding assistants. -
YAML/TOML translation utilities — Internal translation layer for converting between YAML and TOML configuration formats, supporting platforms with different serialization requirements.
- Fix Gemini argument variable translation — Corrected the variable substitution mapping for Gemini CLI. The canonical
$ARGUMENTSvariable now correctly translates to{{argument}}instead of the incorrect{{args}}.
- Tests: Added comprehensive integration tests for the repo, git, backup, and editor packages; removed unused test helper functions.
- Docs: Added security review checklist to the contribution guide with PR self-review guidance.
- CI: Improved release workflow reliability by using file-based p12 certificate handling.
No breaking changes. No migrations required. Standard upgrade path.
This release adds support for Gemini CLI as a target platform, completing the initial vision of aix as a unified configuration manager across Claude Code, OpenCode, Codex, and now Gemini CLI. The release also includes documentation cleanup and CI improvements for macOS binary signing.
- Gemini CLI Platform Support: Full platform adapter implementation enabling skill, command, agent, and MCP server installation for Gemini CLI. Includes variable translation between canonical (
$ARGUMENTS) and Gemini ({{argument}}) syntax, MCP configuration translation, and proper config path resolution.
- Fixed CI test failures caused by
XDG_CONFIG_HOMEenvironment variable interference in path resolution tests.
- Release workflow now runs on
macos-latestwith code signing secrets configured for proper macOS binary distribution. - Documentation cleaned of emojis and non-ASCII characters for consistent, portable output across all terminals.
- 67b93c3 ci: run release on macos-latest with signing secrets
0.1.0 - 2024-01-24
- Initial release of
aix- unified CLI for AI coding assistant configurations - Core skill management (init, validate, install, list)
- Core command management (init, validate, install, list)
- Core agent management (init, validate, install, list)
- MCP server configuration support
- Multi-platform support for Claude Code and OpenCode
- Repository management for shareable resources
- Cross-platform translation layer for configuration formats
- Comprehensive validation for skills, commands, and agents
- Nothing yet.
- Nothing yet.
- Nothing yet.
- Nothing yet.
- Nothing yet.