An open API service indexing awesome lists of open source software.

https://github.com/captain-corgi/marketplace

Claude Code Marketplace hosted by Captain Corgi
https://github.com/captain-corgi/marketplace

claude-code claude-code-plugin

Last synced: about 2 months ago
JSON representation

Claude Code Marketplace hosted by Captain Corgi

Awesome Lists containing this project

README

          

# ๐Ÿ• Corgi Hub Plugins

A comprehensive Claude Code plugin marketplace featuring the **Corgi Greeting Team** - demonstrating plugin capabilities including agents, commands, hooks, and MCP servers.

## ๐ŸŽ‰ Meet the Team

| Corgi | Role | Specialty |
|-------|------|-----------|
| ๐ŸŽ–๏ธ **Captain Corgi** | Team Leader | Formal, professional greetings |
| ๐ŸŽ‰ **Cheerful Charlie** | Enthusiasm Expert | Casual greetings, celebrations |
| ๐Ÿงก **Cozy Cinnamon** | Comfort Specialist | Supportive, encouraging messages |
| ๐Ÿ’ป **Code Corgi** | Developer Buddy | Programming puns, dev greetings |

## ๐Ÿ“ฆ Installation

### Add the Marketplace

```bash
/plugin marketplace add captain-corgi/corgi-hub-plugins
```

Or for local development:

```bash
/plugin marketplace add ./path/to/marketplace
```

### Install the Plugin

```bash
/plugin install greeting-plugin@corgi-hub-plugins
```

## ๐Ÿš€ Features

### Slash Commands

| Command | Description |
|---------|-------------|
| `/greet` | Get a greeting from a random corgi |
| `/welcome` | Formal welcome from Captain Corgi |
| `/farewell` | Cheerful goodbye from Charlie |
| `/motivate` | Encouragement from Cozy Cinnamon |
| `/celebrate` | Team celebration for achievements |
| `/corgi-team` | Meet all the corgis |

### Agents

Four specialized AI agents, each with unique personalities:

- **Captain Corgi** - Professional, dignified greetings
- **Cheerful Charlie** - Energetic, fun interactions
- **Cozy Cinnamon** - Warm, supportive encouragement
- **Code Corgi** - Developer humor and programming puns

### Hooks

Automatic encouragement during your coding sessions:

- **PreToolUse**: Code Corgi encourages you before file edits
- **PostToolUse**: Cheerful Charlie celebrates successful saves
- **Notification**: Team presence for all notifications

### MCP Server

A full-featured greeting service with tools:

| Tool | Description |
|------|-------------|
| `get_greeting` | Get customized greeting by mood/occasion |
| `get_random_corgi` | Get random team member info |
| `add_custom_greeting` | Store your own greetings |
| `get_greeting_stats` | View usage statistics |
| `get_programming_pun` | Get a random programming joke |

**Resources:**
- `corgi://team` - Team member information
- `corgi://greetings/today` - Today's greeting history
- `corgi://greetings/custom` - Your custom greetings

### LSP Server (Reference Implementation)

The plugin includes an LSP server as a reference implementation (not currently integrated into Claude Code plugin system):

- **Completions** - Greeting phrase suggestions in comments
- **Hover** - Corgi wisdom on keywords like TODO, FIXME, etc.
- **Diagnostics** - Hints for friendlier comment wording

> Note: LSP servers are not currently supported in the Claude Code plugin schema. This code is provided as an example for future use.

## ๐Ÿ› ๏ธ Development

### Building the MCP Server

```bash
cd plugins/greeting-plugin/mcp-server
npm install
npm run build
```

### Building the LSP Server

```bash
cd plugins/greeting-plugin/lsp-server
npm install
npm run build
```

### Validating the Marketplace

```bash
/plugin validate .
```

## ๐Ÿ“ Directory Structure

```
marketplace/
โ”œโ”€โ”€ .claude-plugin/
โ”‚ โ””โ”€โ”€ marketplace.json # Marketplace catalog
โ”œโ”€โ”€ plugins/
โ”‚ โ””โ”€โ”€ greeting-plugin/
โ”‚ โ”œโ”€โ”€ .claude-plugin/
โ”‚ โ”‚ โ””โ”€โ”€ plugin.json # Plugin manifest
โ”‚ โ”œโ”€โ”€ agents/ # 4 corgi agents
โ”‚ โ”œโ”€โ”€ commands/ # 6 slash commands
โ”‚ โ”œโ”€โ”€ mcp-server/ # TypeScript MCP server
โ”‚ โ””โ”€โ”€ lsp-server/ # TypeScript LSP server
โ”œโ”€โ”€ LICENSE
โ””โ”€โ”€ README.md
```

## ๐Ÿ“– Plugin Capabilities Demonstrated

This marketplace serves as a comprehensive example of Claude Code plugin features:

- โœ… **Agents** - Specialized AI personas with unique behaviors
- โœ… **Commands** - Custom slash commands for user interaction
- โœ… **Hooks** - Pre/Post tool use and notification handlers
- โœ… **MCP Server** - Model Context Protocol tools and resources
- ๐Ÿ“ฆ **LSP Server** - Reference implementation (not yet supported in plugin schema)

## ๐Ÿค Contributing

Contributions welcome! Feel free to:

1. Fork the repository
2. Create a feature branch
3. Add your own corgi or greeting commands
4. Submit a pull request

## ๐Ÿ“„ License

MIT License - See [LICENSE](LICENSE) for details.

---

**Made with ๐Ÿงก by the Corgi Greeting Team**

*"Spreading joy, one greeting at a time!"* ๐Ÿ•โœจ