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

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

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