# Ay Claude Templates

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-walidboulanouar-ay-claude-templates`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [walidboulanouar](https://agentstack.voostack.com/s/walidboulanouar)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [walidboulanouar](https://github.com/walidboulanouar)
- **Source:** https://github.com/walidboulanouar/ay-claude-templates
- **Website:** https://ayclaude.com

## Install

```sh
agentstack add mcp-walidboulanouar-ay-claude-templates
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# AY Claude CLI

[](https://www.npmjs.com/package/@ay-claude/cli)
[](https://opensource.org/licenses/MIT)
[](https://www.typescriptlang.org/)
[](https://nodejs.org/)

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

```bash
npm install -g @ay-claude/cli
```

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

```bash
ay-claude --version
# or
ayc --version
```

**📦 Package**: [@ay-claude/cli on npm](https://www.npmjs.com/package/@ay-claude/cli)

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

```bash
ay-claude login
```

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

### 2. Search for Packages

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

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

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

```bash
# 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 ` - Show package details
- `health [package]` - Show health scores
- `compare ` - Compare packages
- `recommendations` - Get smart recommendations

### Installation
- `install [packages...]` - Install packages
- `bundle  [bundleId]` - Install bundles
- `list` - List installed packages
- `update [packages...]` - Update packages
- `uninstall ` - Remove packages
- `updates` - Check for updates

### Organization
- `favorite  [packageId]` - Manage favorites
- `workspace  [workspaceId]` - Manage workspaces
- `template  [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:

```bash
# 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:

```bash
# 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](./docs/DEVELOPER_DOCUMENTATION.md)
- [Architecture](./docs/ARCHITECTURE.md)
- [Security Plan](./docs/SECURITY_PLAN.md)
- [Claude Code Integration](./docs/CLAUDE_CODE_INTEGRATION.md)
- [Cross-Platform Guide](./docs/CROSS_PLATFORM.md)
- [Features](./docs/FEATURES.md)

## 🤝 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](./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](https://www.npmjs.com/package/@ay-claude/cli)
- **Repository**: [GitHub](https://github.com/walidboulanouar/ay-claude-templates)
- **Issues**: [GitHub Issues](https://github.com/walidboulanouar/ay-claude-templates/issues)
- **Email**: support@ay-claude.com

---

**Made with ❤️ for the Claude community**

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [walidboulanouar](https://github.com/walidboulanouar)
- **Source:** [walidboulanouar/ay-claude-templates](https://github.com/walidboulanouar/ay-claude-templates)
- **License:** MIT
- **Homepage:** https://ayclaude.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-walidboulanouar-ay-claude-templates
- Seller: https://agentstack.voostack.com/s/walidboulanouar
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.