gosu-claude
Gosu Claude Code Plugins & Marketplace - A collection of plugins that extend Claude Code with specialized agents, skills, commands, and hooks for enhanced coding workflows.
Features Overview
- Specialized AI Agents: Code reviewers, spec reviewers, test runners, and brainstorming agents
- Task Management: Advanced markdown-based task tracking with hierarchical structure and progress monitoring
- GitHub PR Utilities: Automated PR review comment management and bot feedback processing
- Git Worktree Management: Streamlined worktree creation and configuration for isolated development
- Voice Coding: Enhanced voice input processing for natural coding sessions
- MCP Integration: Direct integration with Model Context Protocol servers including Codex CLI
Quick Start
1. Add the Gosu Marketplace
Run this slash command in Claude Code to add the gosu-code marketplace:
/plugin marketplace add gosu-code/claude-plugin
2. Install Plugins
Install the gosu-mcp-core plugin:
/plugin install gosu-mcp-core@gosu-code
Optional plugins:
/plugin install codex-mcp@gosu-code
/plugin install voice-coding@gosu-code
3. Configure MCP Server (gosu-mcp-core only)
After installing gosu-mcp-core, restart Claude Code, then run:
/gosu-mcp-core:install-gosu-model-context-protocol
Prerequisites for MCP server installation:
- Docker installed and running
- GitHub CLI (
gh) installed and authenticated (gh auth login)
Plugins
gosu-mcp-core
Core plugin providing essential development workflow tools and integrations with the Gosu MCP server.
Components:
- 6 Specialized Agents (code review, spec review, spec verification, test running, brainstorming, dynamic)
- 3 Skills (task-list-md, github-pr-utils, git-worktree)
- 1 Command (MCP server installation)
- 1 Hook (dangerous tool usage blocker)
View detailed documentation →
codex-mcp
Integrates Codex CLI as a companion AI agent via MCP, enabling delegation of complex workflows and MCP tool invocations.
Components:
- 1 Skill (codex-mcp for agent delegation)
- MCP server configuration for Codex integration
Prerequisites:
codex CLI installed (npm install -g @openai/codex)
- OpenAI account authentication (
codex login)
View detailed documentation →
voice-coding
Enhances voice coding sessions with intelligent prompt processing for natural speech-to-code workflows.
Components:
- 1 Hook (voice input prompt enhancer)
View detailed documentation →
Usage Examples
Using Task List Management
Use script as CLI manual tool
You can use the task_list_md.py script manually to manage tasks in markdown files by create a symbolic link to the script as follows:
sudo ln -s ~/.claude/plugins/marketplaces/gosu-code/plugins/gosu-mcp-core/skills/task-list-md/scripts/task_list_md.py /usr/local/bin/task_list_md.py
Now you can invoke the script from anywhere with task_list_md.py command. For example, To track your development tasks with hierarchical markdown checklists:
# List all tasks
task_list_md.py list-tasks tasks.md
# Add a new task
task_list_md.py add-task tasks.md 1.1 "Implement user authentication"
# Update task status
task_list_md.py set-status tasks.md 1.1 in-progress
# Get next actionable task
task_list_md.py get-next-task tasks.md
Use skill within Claude Code
You can also use the task-list-md skill within Claude Code to manage your tasks directly from the chat interface.For example:
Use skill to:
- add a new task "Implement user authentication" in tasks.md which depends on task 1.1
- add a new subtask "Design login page" under task 3 in tasks.md
- list all tasks in tasks.md
Running Code Reviews
Ask Claude Code to review your code and the gosu-code-reviewer agent will automatically analyze it:
Review my TypeScript service class in src/services/user.service.ts for best practices
Managing GitHub PR Comments
Ask Claude Code to Fetch and analyse bot-generated review comments using the github-pr-utils skill:
Use skill to fetch and analyze GitHub PR #42 comments for bot-generated feedback.
Then for each comment that you disagree with, reply with a polite explanation and resolve the comment.
Creating Git Worktrees
Ask Claude Code to quickly create an isolated worktree environment for a new feature branch:
Use skill to create git worktree for branch feature/new-api and open it in a new Code editor window
Troubleshooting
Plugin Marketplace Not Found
If the marketplace add command fails:
- Verify you're using a compatible version of Claude Code
- Check your internet connection
- Try again after a few minutes
MCP Server Installation Fails
Common issues and solutions: