AY Claude CLI

Official CLI tool for AY Claude Platform - Discover, install, and manage Claude Skills, Agents, Commands, Hooks, Plugins, MCPs, and Settings. Cross-platform package manager for Claude Code extensions.

📦 Installation

npm install -g @ay-claude/cli

After installation, the CLI will be available as ay-claude or ayc:

ay-claude --version
# or
ayc --version

📦 Package: @ay-claude/cli on npm

✨ Features

🔐 Secure & Authenticated

• OAuth Device Flow authentication
• Secure token storage (system keychain)
• Package verification (5-stage security pipeline)
• Request signing and audit logging

📦 Complete Package Management

• Install Skills, Agents, Commands, Hooks, Plugins, MCPs, and Settings
• Global & Local installation (~/.claude or ./.claude)
• Dependencies auto-installation
• Version Management with rollback support
• Package Bundles - Install curated collections

🔍 Smart Discovery

• Unified Search across all content types
• Smart Recommendations based on installed packages
• Package Health Scores - Know package quality
• Package Comparison - Compare similar packages
• Search History - Remember your searches

⭐ Organization

• Favorites - Save favorite packages
• Collections - Organize packages
• Team Workspaces - Share configurations
• Package Templates - Quick start scaffolding

🛠️ Developer Experience

• Beautiful CLI output with colors and tables
• Comprehensive help system
• Troubleshooting diagnostics
• Cross-platform support (Windows, Linux, macOS)
• Claude Code integration (zero configuration)

🎯 Quick Start

1. Authenticate

ay-claude login

This will open your browser for authentication. Follow the instructions.

2. Search for Packages

# Search across all types
ay-claude search "automation"

# Filter by type
ay-claude search "react" --type skill

# Browse by category
ay-claude browse --category "development"

3. Install Packages

# Install a package
ay-claude install package-name

# Install with dependencies
ay-claude install package-name

# Install a bundle
ay-claude bundle install react-dev-stack

# Install globally
ay-claude install package-name --global

# Install locally (project-specific)
ay-claude install package-name --local

4. Manage Packages

# List installed packages
ay-claude list

# Check package health
ay-claude health package-name

# Compare packages
ay-claude compare package1 package2 package3

# Update packages
ay-claude updates --install

# Uninstall
ay-claude uninstall package-name

5. Organize

# Add to favorites
ay-claude favorite add package-name

# Create collection
ay-claude favorite create "My Tools"

# Get recommendations
ay-claude recommendations

# View search history
ay-claude search-history

📚 Commands

Authentication

• login - Authenticate with AY Claude Platform
• logout - Log out and remove credentials
• whoami - Show authentication status

Discovery

• search [query] - Search marketplace
• browse - Browse all content
• info <package> - Show package details
• health [package] - Show health scores
• compare <packages...> - Compare packages
• recommendations - Get smart recommendations

Installation

• install [packages...] - Install packages
• bundle <action> [bundleId] - Install bundles
• list - List installed packages
• update [packages...] - Update packages
• uninstall <package> - Remove packages
• updates - Check for updates

Organization

• favorite <action> [packageId] - Manage favorites
• workspace <action> [workspaceId] - Manage workspaces
• template <action> [templateId] - Create from templates
• search-history - View search history

Utilities

• init - Initialize CLI
• stats - Show statistics
• troubleshoot - Run diagnostics
• help [command] - Show help

🎁 Package Bundles

Install curated collections of packages:

# List available bundles
ay-claude bundle list

# Install React development stack
ay-claude bundle install react-dev-stack

# Available bundles:
# - react-dev-stack (React + TypeScript + Formatting)
# - nodejs-backend (Node.js + API + Testing)
# - code-quality (Linting + Formatting + Testing)
# - git-workflow (Git automation tools)

📝 Package Templates

Create new packages quickly:

# List templates
ay-claude template list

# Create from template
ay-claude template create skill-basic

🔒 Security

The CLI implements multiple security layers:

• OAuth Device Flow - Secure authentication without browser redirect
• Package Verification - 5-stage security pipeline
• Request Signing - HMAC-SHA256 request signatures
• Audit Logging - Complete operation tracking
• Rate Limiting - Prevents abuse

🌍 Cross-Platform

Works seamlessly on:

• ✅ macOS (tested)
• ✅ Linux (tested)
• ✅ Windows (tested)

📖 Documentation

• Full Documentation
• Architecture
• Security Plan
• Claude Code Integration
• Cross-Platform Guide
• Features

🤝 Contributing

Contributions are welcome! Please read our contributing guidelines.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built for the AY Claude Platform
• Integrates with Claude Code
• Inspired by npm, pip, and other great package managers

📞 Support

• Package: @ay-claude/cli on npm
• Repository: GitHub
• Issues: GitHub Issues
• Email: [email protected]

---

Made with ❤️ for the Claude community