xo-agent (Beta)

A powerful CLI tool for managing AI agent projects. Easily add skills, commands, and sub-agents to your Antigravity or Claude AI projects.

Features

• 🎯 Interactive Mode - Guided workflow with checkbox selection for multiple items
• 🚀 Direct Commands - Quick CLI commands for adding skills, commands, and agents
• 🔧 Template-Based - Pre-built templates for common use cases
• 🤖 Multi-Platform - Supports both Antigravity (.agent) and Claude (.claude) projects
• 📦 Smart Processing - Automatic directive processing with FileBuilder (@include, code execution)

Installation

npm install -g xo-agent
# or
pnpm add -g xo-agent

Usage

Interactive Mode (Recommended)

Simply run xo-agent without arguments to launch the interactive wizard:

xo-agent

The interactive mode will:

1. Ask what you want to add (Skill, Command, or Agent)
2. Let you select the target agent (Antigravity or Claude)
3. Show a checkbox list to select multiple items
4. Copy all selected items to your project

Direct Commands

Add Skills

Add pre-built skills to your agent project:

# Interactive selection
xo-agent add-skill --agent antigravity

# Add specific skill
xo-agent add-skill example-skill --agent claude

Add Commands

Add workflow commands to your agent:

# Interactive selection
xo-agent add-command --agent antigravity

# Add specific command
xo-agent add-command deploy --agent claude

Add Agents

Add sub-agents to your project:

# Interactive selection
xo-agent add-agent --agent antigravity

# Add specific agent
xo-agent add-agent code-reviewer --agent claude

Available Templates

Skills

• example-skill - Example skill template

Commands

• deploy - Deploy application to production
• test - Run all tests and generate coverage report

Agents

• code-reviewer - Automated code review agent for pull requests
• documentation-writer - Automated documentation generation agent

Project Structure

After using xo-agent, your project will have the following structure:

your-project/
├── .agent/                    # Antigravity agent directory
│   ├── skills/               # Skills directory
│   ├── workflows/            # Workflow commands
│   └── agents/               # Sub-agents
└── .claude/                   # Claude agent directory
    ├── skills/
    ├── commands/
    └── agents/

Options

All commands support the following options:

• -a, --agent <type> - Specify agent type (antigravity or claude)
• -h, --help - Display help for command

Examples

Add multiple skills at once

xo-agent
# → Select "Skill"
# → Select "Antigravity"
# → Check multiple skills with spacebar
# → Press enter to confirm

Quick add with options

# Add deploy command to Antigravity
xo-agent add-command deploy --agent antigravity

# Add code-reviewer agent to Claude
xo-agent add-agent code-reviewer --agent claude

Development

# Clone the repository
git clone https://github.com/yourusername/xo-agent.git
cd xo-agent

# Install dependencies
pnpm install

# Build
pnpm build

# Link for local testing
pnpm link --global

# Test the CLI
xo-agent --help

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.