a2ax-cli

Unified skill management for AI code assistants

!Version
!License
!Node

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

``bash
npm install -g a2ax-cli
`

$3

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

Quick Start

`bash


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

$3

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

`bash
a2ax
`

$3

| Command | Aliases | Description |
|---------|---------|-------------|
| install | i, add | Install a skill to AI agents |
| uninstall | remove, rm | Uninstall a skill from AI agents |
| update | upgrade | Update a skill to the latest version |
| disable | - | Disable a skill (preserves files) |
| enable | - | 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 |

$3

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

$3

`bash


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.

$3

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

$3

`bash


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.

$3

`bash


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
`

$3

Create a Git repository with a marketplace.json file:

`json
{
"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

$3

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

$3

| 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:

`markdown
---
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...
`

$3

Skills are detected from files in this order of priority:
1. SKILL.md
2. skill.md
3. README.md
4. readme.md

Development

`bash


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
``

$3

- 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