https://github.com/agentsdance/agentx
AgentX - Agent Extension: MCP Servers, Agent Skills and Plugins Manager
https://github.com/agentsdance/agentx
agent code-agent mcp plugin skills
Last synced: 11 days ago
JSON representation
AgentX - Agent Extension: MCP Servers, Agent Skills and Plugins Manager
- Host: GitHub
- URL: https://github.com/agentsdance/agentx
- Owner: agentsdance
- License: apache-2.0
- Created: 2026-01-09T15:33:11.000Z (18 days ago)
- Default Branch: master
- Last Pushed: 2026-01-10T16:17:18.000Z (17 days ago)
- Last Synced: 2026-01-11T01:24:28.214Z (16 days ago)
- Topics: agent, code-agent, mcp, plugin, skills
- Language: Go
- Homepage:
- Size: 11.9 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# AgentX
AgentX stands for Agent eXtension: A unified CLI tool for managing **MCP (Model Context Protocol) Servers** and **Skills** across multiple AI coding agents.
## Overview
AgentX simplifies the installation, management, and monitoring of MCP servers and skills across popular AI coding tools:
- **Claude Code**
- **Cursor**
- **Gemini CLI**
- **OpenCode**
It provides both a command-line interface and an interactive terminal UI (TUI) for seamless configuration management.
## Features
### MCP Server Management
- Install/remove MCP servers across multiple agents
- Check installation status
- Bulk installation to all supported agents
- Supported MCP servers:
- **Playwright** - Browser automation capabilities
- **Context7** - Library documentation access
### Claude Code Skills Management
- Install skills from local paths or Git repositories
- Support for skill directories (with `SKILL.md`) and command files (`.md`)
- Install from GitHub URLs with tree fragments
- Personal and project scope management
- Skills health checking and validation
### Interactive TUI
- Three main tabs: MCP Servers, Skills, Code Agents
- Visual status matrix showing MCP installations across agents
- Keyboard shortcuts for quick navigation
- Real-time status updates
## Installation
### Homebrew (macOS/Linux)
```bash
# Add the tap (points to this repo)
brew tap agentsdance/agentx https://github.com/agentsdance/agentx.git
# Install agentx
brew install agentx
```
### Download Binary
Download the latest release from [GitHub Releases](https://github.com/agentsdance/agentx/releases).
### Build from Source
```bash
# Clone the repository
git clone https://github.com/agentsdance/agentx.git
cd agentx
# Build
make build
# Install to /usr/local/bin (customize with PREFIX env var)
make install
```
### Prerequisites
- **Go 1.25+** for building
- **Node.js with npm** for MCP server execution (via npx)
- **Git** for cloning skill repositories
## Usage
### Interactive Mode
Launch the interactive TUI:
```bash
agentx
```
Use keyboard shortcuts to navigate:
- `Tab` / `Shift+Tab` - Switch between tabs
- `↑` / `↓` - Navigate items
- `Enter` - Select/toggle
- `q` / `Ctrl+C` - Quit
### CLI Commands
### Command Aliases
The tool responds to: `agentx`, `agents`, or `ax`
## Configuration
### Agent Configuration Locations
| Agent | Config Path |
|-------|-------------|
| Claude Code | `~/.claude.json` |
| Cursor | `~/.cursor/mcp.json` |
| Gemini CLI | `~/.gemini/settings.json` |
| OpenCode | `~/.opencode/config.json` |
### Skills Storage
| Scope | Skills Directory | Commands Directory |
|-------|------------------|-------------------|
| Personal | `~/.claude/skills/` | `~/.claude/commands/` |
| Project | `.claude/skills/` | `.claude/commands/` |
## Project Structure
```
agentx/
├── cmd/ # CLI commands
├── internal/
│ ├── agent/ # Agent implementations (Claude, Cursor, Gemini, OpenCode)
│ ├── config/ # Configuration management
│ ├── skills/ # Skills management
│ ├── mcp/ # MCP-specific logic
│ └── version/ # Version information
├── ui/
│ ├── components/ # Reusable UI components
│ ├── views/ # Tab views (MCP, Skills, Agents)
│ └── theme/ # Styling
├── main.go # Entry point
├── Makefile # Build targets
└── go.mod # Go module definition
```
## Available Skills
AgentX comes with pre-configured skills:
| Skill | Description |
|-------|-------------|
| `frontend-design` | Production-grade UI design |
| `mcp-builder` | Build MCP servers |
| `pdf` | PDF document handling |
| `docx` | Word document handling |
| `xlsx` | Excel document handling |
| `pptx` | PowerPoint document handling |
## License
Apache 2.0 - See [LICENSE](LICENSE) for details.