aix

module

v0.7.0 Latest Latest Go to latest Published: Feb 8, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/thoreinstein/aix

Links

Open Source Insights

README ¶

aix

A unified CLI for managing AI coding assistant configurations across platforms.

Overview

aix provides a single tool to manage skills, MCP servers, and slash commands for multiple AI coding assistants:

Claude Code
OpenCode
Codex CLI
Gemini CLI

Write once, deploy everywhere. Define your configurations in a platform-agnostic format and let aix handle the translation to each platform's native format.

Installation

Homebrew (macOS/Linux)

brew install thoreinstein/tap/aix

Standalone Script (macOS/Linux)

curl -fsSL https://raw.githubusercontent.com/thoreinstein/aix/main/install.sh | sh

From Source

go install github.com/thoreinstein/aix/cmd/aix@latest

Getting Started

Initialize Configuration

Bootstrap aix by detecting installed AI platforms and creating a configuration file.
```
aix init
```
This creates ~/.config/aix/config.yaml with your detected platforms.
Verify Configuration
```
aix config list
```

Usage

Global Options

Target specific platforms using the --platform (or -p) flag. If omitted, aix targets all configured/detected platforms.

# Target only Claude
aix mcp list --platform claude

# Target OpenCode and Gemini
aix mcp list -p opencode -p gemini

MCP Server Management

Manage Model Context Protocol (MCP) servers.

# Add a server
aix mcp add github npx -y @modelcontextprotocol/server-github --env GITHUB_TOKEN=ghp_...

# List configured servers
aix mcp list

# Show server details and status
aix mcp show github

# Enable/Disable a server
aix mcp disable github
aix mcp enable github

# Remove a server
aix mcp remove github

Skill Management

Manage reusable skills (prompts/tools) across platforms.

# Initialize a new skill from a template
aix skill init my-skill

# Install a skill to all platforms
aix skill install ./my-skill.md

# List installed skills
aix skill list

# Show skill details
aix skill show my-skill

# Remove a skill
aix skill remove my-skill

Slash Command Management

Manage custom slash commands.

# Initialize a new command
aix command init /deploy

# Install a command
aix command install ./deploy.md

# List commands
aix command list

# Remove a command
aix command remove /deploy

Repository Management

Manage remote repositories containing shareable skills, commands, agents, and MCP configurations. See Repository Documentation for complete details.

# Add a community repository
aix repo add https://github.com/example/aix-skills

# Search for resources across all repos
aix search "code review"

# Install a skill from a repo
aix skill install community-repo/code-reviewer

Additional repository commands:

# List configured repositories
aix repo list

# Update repositories to get latest changes
aix repo update

# Remove a repository
aix repo remove agents

Agent Management

Manage AI agent configurations (primarily for Claude Code and OpenCode).

# List available agents
aix agent list

# Show agent details
aix agent show my-agent

Configuration

Manage aix's own configuration.

# View all settings
aix config list

# Get a specific value
aix config get default_platforms

# Set a value
aix config set default_platforms claude,opencode,gemini

# Edit config file in your default editor
aix config edit

Architecture

See docs/adr/001-unified-agent-cli.md for the full architecture decision record.

License

MIT - see LICENSE for details.

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
aix command
aix/commands Package commands provides CLI commands for the aix tool.	Package commands provides CLI commands for the aix tool.
aix/commands/agent Package agent provides commands for managing AI coding agents.	Package agent provides commands for managing AI coding agents.
aix/commands/backup Package backup provides CLI commands for managing configuration backups.	Package backup provides CLI commands for managing configuration backups.
aix/commands/command Package command provides the command group for managing AI assistant slash commands.	Package command provides the command group for managing AI assistant slash commands.
aix/commands/flags Package flags provides shared flag accessors for CLI commands.	Package flags provides shared flag accessors for CLI commands.
aix/commands/mcp Package mcp provides the mcp command group for managing MCP server configurations.	Package mcp provides the mcp command group for managing MCP server configurations.
aix/commands/repo Package repo provides CLI commands for managing skill repositories.	Package repo provides CLI commands for managing skill repositories.
aix/commands/search Package search provides the search command for finding resources across cached repositories.	Package search provides the search command for finding resources across cached repositories.
aix/commands/skill Package skill provides the skill command group for managing AI assistant skills.	Package skill provides the skill command group for managing AI assistant skills.
internal
agent/validator Package validator provides validation for agent structs.	Package validator provides validation for agent structs.
backup Package backup provides configuration backup and restore capabilities for aix.	Package backup provides configuration backup and restore capabilities for aix.
cli Package cli provides CLI-specific types and utilities for the aix command.	Package cli provides CLI-specific types and utilities for the aix command.
cli/mocks
cli/prompt Package prompt provides interactive CLI prompts for user input.	Package prompt provides interactive CLI prompts for user input.
command Package command provides slash command parsing and validation.	Package command provides slash command parsing and validation.
command/parser Package parser provides command file parsing functionality.	Package parser provides command file parsing functionality.
command/parser/mocks
command/validator Package validator provides validation for command structs.	Package validator provides validation for command structs.
config Package config provides configuration management for aix using Viper.	Package config provides configuration management for aix using Viper.
doctor Package doctor provides diagnostic and validation utilities for aix configurations.	Package doctor provides diagnostic and validation utilities for aix configurations.
editor Package editor provides utilities for launching the user's preferred text editor.	Package editor provides utilities for launching the user's preferred text editor.
errors Package errors provides error handling conventions for the aix CLI.	Package errors provides error handling conventions for the aix CLI.
git Package git provides Git operation wrappers for cloning and updating repositories.	Package git provides Git operation wrappers for cloning and updating repositories.
install
logging Package logging provides structured logging for the aix CLI using slog.	Package logging provides structured logging for the aix CLI using slog.
mcp Package mcp provides canonical MCP (Model Context Protocol) server configuration types that serve as the bridge between different AI assistant platforms.	Package mcp provides canonical MCP (Model Context Protocol) server configuration types that serve as the bridge between different AI assistant platforms.
mcp/mocks
mcp/parser Package parser provides JSON parsing and writing for canonical MCP configurations.	Package parser provides JSON parsing and writing for canonical MCP configurations.
mcp/validator
paths Package paths provides cross-platform path resolution utilities for AI coding assistant configuration directories.	Package paths provides cross-platform path resolution utilities for AI coding assistant configuration directories.
platform Package platform provides platform detection and registration for AI coding assistant configuration management.	Package platform provides platform detection and registration for AI coding assistant configuration management.
platform/claude Package claude provides data models for Claude Code configuration entities.	Package claude provides data models for Claude Code configuration entities.
platform/gemini Package gemini provides Gemini CLI specific configuration and path handling.	Package gemini provides Gemini CLI specific configuration and path handling.
platform/opencode Package opencode provides OpenCode specific configuration and path handling.	Package opencode provides OpenCode specific configuration and path handling.
repo Package repo provides repository management for skill repositories.	Package repo provides repository management for skill repositories.
resource Package resource provides types and utilities for discovering shareable aix resources (skills, commands, agents, and MCP servers) from repositories.	Package resource provides types and utilities for discovering shareable aix resources (skills, commands, agents, and MCP servers) from repositories.
skill/parser Package parser provides SKILL.md file parsing functionality.	Package parser provides SKILL.md file parsing functionality.
skill/toolperm Package toolperm provides parsing and validation for tool permission syntax as defined in the Agent Skills Specification.	Package toolperm provides parsing and validation for tool permission syntax as defined in the Agent Skills Specification.
skill/validator Package validator provides validation for Skill structs per the Agent Skills Specification.	Package validator provides validation for Skill structs per the Agent Skills Specification.
translate
validator Package validator provides a unified validation framework for aix components.	Package validator provides a unified validation framework for aix components.
pkg
fileutil Package fileutil provides file system utilities including atomic write operations.	Package fileutil provides file system utilities including atomic write operations.
frontmatter Package frontmatter provides utilities for parsing and formatting YAML frontmatter in markdown files.	Package frontmatter provides utilities for parsing and formatting YAML frontmatter in markdown files.