a2ax-cli

Unified skill management for AI code assistants

A2AX CLI is an interactive terminal tool for installing, managing, and syncing AI agent skills across multiple AI code assistants from a single interface.

Features

• Unified Skill Management - Install, update, and remove skills across 17 AI agents from one CLI
• Interactive Terminal UI - Beautiful React/Ink-powered interface with keyboard navigation
• Marketplace Integration - Discover and install skills from curated marketplaces
• Multiple Installation Modes - Choose between symlink (shared) or copy (isolated) installations
• Flexible Scopes - Install skills globally or per-project
• Git-Based Skills - Install skills directly from any Git repository

Supported AI Agents

A2AX CLI supports 17 AI code assistants:

| Agent | Description | |-------|-------------| | Claude Code | Anthropic Claude Code CLI | | Cursor | Cursor AI IDE | | Windsurf | Codeium Windsurf IDE | | GitHub Copilot | GitHub Copilot | | Roo Code | Roo Code AI assistant | | OpenCode | OpenCode AI coding assistant | | Cline | Cline VS Code extension | | Amp | Sourcegraph Amp | | Aider | Aider AI pair programming | | Codex | OpenAI Codex CLI | | Continue | Continue IDE extension | | Void | Void AI assistant | | PearAI | PearAI IDE | | Zed | Zed code editor | | Trae | Trae AI IDE | | Melty | Melty AI assistant | | Aide | Aide AI coding assistant |

Installation

npm install -g a2ax-cli

Prerequisites

• Node.js >= 18.0.0
• Git (for installing skills from repositories)

Quick Start

# Launch interactive mode (default)
a2ax

# Add a marketplace
a2ax marketplace add https://github.com/your-org/skill-marketplace

# Install a skill from marketplace
a2ax install skill-name

# Install a skill from a Git URL
a2ax install https://github.com/user/my-skill

# List installed skills
a2ax list

Usage

Interactive Mode

Running a2ax without arguments launches the interactive terminal UI where you can browse marketplaces, search skills, and manage installations with keyboard navigation.

a2ax

CLI Commands

| Command | Aliases | Description | |---------|---------|-------------| | install <skill> | i, add | Install a skill to AI agents | | uninstall <skill> | remove, rm | Uninstall a skill from AI agents | | update <skill> | upgrade | Update a skill to the latest version | | disable <skill> | - | Disable a skill (preserves files) | | enable <skill> | - | Re-enable a disabled skill | | installed | list, ls | List all installed skills | | marketplace | mp | Manage skill marketplaces | | agents | - | List detected AI agents | | config | - | View or modify configuration | | help | ?, commands | Show available commands |

Common Options

-a, --agent <agent>       Target a specific agent (e.g., claude-code, cursor)
-s, --scope <scope>       Installation scope: global or project
-m, --mode <mode>         Installation mode: symlink or copy

Examples

# Install a skill globally for all agents
a2ax install code-review --scope global

# Install a skill only for Claude Code
a2ax install refactoring --agent claude-code

# Install with copy mode (isolated installation)
a2ax install testing-utils --mode copy

# Update all skills for Cursor
a2ax update --agent cursor

# List skills installed for a specific agent
a2ax list --agent windsurf

Configuration

Configuration is stored at ~/.a2ax/config.json.

Options

| Option | Default | Description | |--------|---------|-------------| | defaultInstallMode | "symlink" | Default installation mode (symlink or copy) | | defaultScope | "global" | Default installation scope (global or project) |

Managing Configuration

# View all configuration
a2ax config

# View a specific setting
a2ax config defaultInstallMode

# Set a configuration value
a2ax config defaultInstallMode copy
a2ax config defaultScope project

Marketplace

Marketplaces are Git repositories containing curated collections of skills.

Managing Marketplaces

# Add a marketplace
a2ax marketplace add https://github.com/org/marketplace-repo

# List configured marketplaces
a2ax marketplace list

# Sync marketplace data (fetch latest skills)
a2ax marketplace sync

# Remove a marketplace
a2ax marketplace remove marketplace-id

Hosting Your Own Marketplace

Create a Git repository with a marketplace.json file:

{
  "name": "My Skill Marketplace",
  "description": "A collection of useful AI agent skills",
  "skills": [
    {
      "name": "code-review",
      "description": "Comprehensive code review skill",
      "repository": "https://github.com/user/code-review-skill",
      "tags": ["review", "quality"],
      "category": "development"
    }
  ]
}

Installation Modes & Scopes

Installation Modes

| Mode | Description | Use Case | |------|-------------|----------| | symlink | Creates symbolic links to the skill source | Shared skills, automatic updates when source changes | | copy | Copies skill files to the target location | Isolated installations, offline usage |

Installation Scopes

| Scope | Location | Description | |-------|----------|-------------| | global | ~/.{agent}/skills/ | Available in all projects | | project | ./{agent}/skills/ | Only available in current project |

Skill Format

Skills are defined using a SKILL.md file with YAML frontmatter:

---
name: my-skill
description: A helpful skill that does something useful
version: 1.0.0
author: Your Name
tags:
  - productivity
  - automation
category: development
license: MIT
repository: https://github.com/user/my-skill
---

# My Skill

Instructions and guidance for the AI agent...

## When to Use

Use this skill when you need to...

## Examples

Here are some examples of how to use this skill...

Supported File Names

Skills are detected from files in this order of priority:

1. SKILL.md
2. skill.md
3. README.md
4. readme.md

Development

# Clone the repository
git clone https://github.com/a2ax-organization/a2ax-cli.git
cd a2ax-cli

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode (watch)
npm run dev

# Run tests
npm test

# Lint and format
npm run lint
npm run format

# Type check
npm run typecheck

Tech Stack

• Runtime: Node.js 18+
• Language: TypeScript 5.3
• UI Framework: React + Ink (Terminal UI)
• Build Tool: tsup
• Testing: Vitest
• Linting: Biome
• Git Operations: simple-git
• Schema Validation: Zod

License

MIT