mirror of
https://github.com/eyaltoledano/claude-task-master.git
synced 2026-01-30 06:12:05 +00:00
78115616ae
Fixes #1550 This PR addresses the documentation chaos reported in issue #1550 by: 1. Creating a comprehensive Claude Code setup guide at apps/docs/integrations/claude-code.mdx that: - Clearly explains all 3 integration options (MCP Server, Plugin, Provider) - Includes a comparison table to help users choose the right option - Clarifies the naming confusion between task-master-ai (MCP package) and task-master (CLI) - Provides comprehensive troubleshooting for common issues 2. Simplifying README.md: - Consolidated duplicate Claude Code installation sections - Added prominent links to the comprehensive guide - Reduced confusion by pointing to single source of truth 3. Updating documentation navigation: - Added new 'Integrations' section to docs.json - Made Claude Code guide easily discoverable 4. Deprecating redundant documentation: - Added deprecation notices to docs/claude-code-integration.md - Added deprecation notices to docs/examples/claude-code-usage.md - Both files now point to the new consolidated guide 5. Adding context to existing files: - Explained CLAUDE.md auto-load purpose - Clarified CLAUDE_CODE_PLUGIN.md is for plugin users - Added setup guide link to TM_COMMANDS_GUIDE.md This creates a single landing page (docs.task-master.dev/integrations/claude-code) that new users can reference, eliminating the confusion from multiple installation methods scattered across 5+ different files. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Ralph Khreish <Crunchyman-ralph@users.noreply.github.com>
143 lines
3.1 KiB
Markdown
143 lines
3.1 KiB
Markdown
# Taskmaster AI - Claude Code Plugin Marketplace
|
|
|
|
> 📖 **Looking for Claude Code setup?** See the [Complete Claude Code Setup Guide](https://docs.task-master.dev/integrations/claude-code) for all integration options (MCP, Plugin, Provider).
|
|
|
|
This document is specifically for **plugin marketplace** installation. The repository includes a Claude Code plugin marketplace in `.claude-plugin/marketplace.json`.
|
|
|
|
## Installation
|
|
|
|
### From GitHub (Public Repository)
|
|
|
|
Once this repository is pushed to GitHub, users can install with:
|
|
|
|
```bash
|
|
# Add the marketplace
|
|
/plugin marketplace add eyaltoledano/claude-task-master
|
|
|
|
# Install the plugin
|
|
/plugin install taskmaster@taskmaster
|
|
```
|
|
|
|
### Local Development/Testing
|
|
|
|
```bash
|
|
# From the project root directory
|
|
cd /path/to/claude-task-master
|
|
|
|
# Build the plugin first
|
|
cd packages/claude-code-plugin
|
|
npm run build
|
|
cd ../..
|
|
|
|
# In Claude Code
|
|
/plugin marketplace add .
|
|
/plugin install taskmaster@taskmaster
|
|
```
|
|
|
|
## Marketplace Structure
|
|
|
|
```
|
|
claude-task-master/
|
|
├── .claude-plugin/
|
|
│ └── marketplace.json # Marketplace manifest (at repo root)
|
|
│
|
|
├── packages/claude-code-plugin/
|
|
│ ├── src/build.ts # Build tooling
|
|
│ └── [generated plugin files]
|
|
│
|
|
└── assets/claude/ # Plugin source files
|
|
├── commands/
|
|
└── agents/
|
|
```
|
|
|
|
## Available Plugins
|
|
|
|
### taskmaster
|
|
|
|
AI-powered task management system for ambitious development workflows.
|
|
|
|
**Features:**
|
|
|
|
- 49 slash commands for comprehensive task management
|
|
- 3 specialized AI agents (orchestrator, executor, checker)
|
|
- MCP server integration
|
|
- Complexity analysis and auto-expansion
|
|
- Dependency management and validation
|
|
- Automated workflow capabilities
|
|
|
|
**Quick Start:**
|
|
|
|
```bash
|
|
/tm:init
|
|
/tm:parse-prd
|
|
/tm:next
|
|
```
|
|
|
|
## For Contributors
|
|
|
|
### Adding New Plugins
|
|
|
|
To add more plugins to this marketplace:
|
|
|
|
1. **Update marketplace.json**:
|
|
|
|
```json
|
|
{
|
|
"plugins": [
|
|
{
|
|
"name": "new-plugin",
|
|
"source": "./path/to/plugin",
|
|
"description": "Plugin description",
|
|
"version": "1.0.0"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
2. **Commit and push** the changes
|
|
|
|
3. **Users update** with: `/plugin marketplace update taskmaster`
|
|
|
|
### Marketplace Versioning
|
|
|
|
The marketplace version is tracked in `.claude-plugin/marketplace.json`:
|
|
|
|
```json
|
|
{
|
|
"metadata": {
|
|
"version": "1.0.0"
|
|
}
|
|
}
|
|
```
|
|
|
|
Increment the version when adding or updating plugins.
|
|
|
|
## Team Configuration
|
|
|
|
Organizations can auto-install this marketplace for all team members by adding to `.claude/settings.json`:
|
|
|
|
```json
|
|
{
|
|
"extraKnownMarketplaces": {
|
|
"task-master": {
|
|
"source": {
|
|
"source": "github",
|
|
"repo": "eyaltoledano/claude-task-master"
|
|
}
|
|
}
|
|
},
|
|
"enabledPlugins": {
|
|
"taskmaster": {
|
|
"marketplace": "taskmaster"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Team members who trust the repository folder will automatically get the marketplace and plugins installed.
|
|
|
|
## Documentation
|
|
|
|
- [Claude Code Plugin Docs](https://docs.claude.com/en/docs/claude-code/plugins)
|
|
- [Marketplace Documentation](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces)
|