@lgcyaxi/oh-my-claude 1.0.0

package/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

package/CLAUDE.md

@@ -0,0 +1,39 @@
+# oh-my-claude Development Guide
+
+## Build Commands
+
+```bash
+bun install          # Install dependencies
+bun run build:all    # Build everything (main, MCP server, hooks)
+bun run typecheck    # TypeScript type checking
+bun test             # Run tests
+```
+
+## Project Structure
+
+- `src/agents/` - Agent definitions with prompts (8 agents)
+- `src/config/` - Configuration schema (Zod validation)
+- `src/providers/` - Multi-provider API clients (DeepSeek, ZhiPu, MiniMax, OpenRouter)
+- `src/mcp/` - Background Agent MCP server
+- `src/hooks/` - Claude Code hook scripts
+- `src/generators/` - Agent .md file generators
+- `src/installer/` - CLI installer
+
+## Architecture
+
+- **Task Tool Agents** (Claude subscription): Sisyphus, Claude-Reviewer, Claude-Scout
+- **MCP Background Agents** (external APIs): Oracle, Librarian, Explore, Frontend-UI-UX, Document-Writer
+
+## Conventions
+
+- Use Bun runtime (not Node.js)
+- All API clients are OpenAI-compatible
+- Agent prompts are in their respective `src/agents/*.ts` files
+- Configuration is validated with Zod schema
+
+## Testing Installation
+
+```bash
+bun run install-local  # Build and install to ~/.claude/
+oh-my-claude doctor    # Verify configuration
+```

package/LICENSE

@@ -0,0 +1,99 @@
+# License
+
+Portions of this software are licensed as follows:
+
+- Agent prompts derived from [oh-my-opencode](https://github.com/nicepkg/opencode) are licensed under the
+  Sustainable Use License (see below).
+- Original agent prompts (src/agents/original/) are available under the MIT License.
+- All third party components incorporated into the oh-my-claude Software are licensed under the original
+  license provided by the owner of the applicable component.
+- Content outside of the above mentioned files or restrictions is available under the "Sustainable Use
+  License" as defined below.
+
+## Sustainable Use License
+
+Version 1.0
+
+### Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+### Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide, non-sublicensable, non-transferable license
+to use, copy, distribute, make available, and prepare derivative works of the software, in each case subject
+to the limitations below.
+
+### Limitations
+
+You may use or modify the software only for your own internal business purposes or for non-commercial or
+personal use. You may distribute the software or provide it to others only if you do so free of charge for
+non-commercial purposes. You may not alter, remove, or obscure any licensing, copyright, or other notices of
+the licensor in the software. Any use of the licensor's trademarks is subject to applicable law.
+
+### Patents
+
+The licensor grants you a license, under any patent claims the licensor can license, or becomes able to
+license, to make, have made, use, sell, offer for sale, import and have imported the software, in each case
+subject to the limitations and conditions in this license. This license does not cover any patent claims that
+you cause to be infringed by modifications or additions to the software. If you or your company make any
+written claim that the software infringes or contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If your company makes such a claim, your patent
+license ends immediately for work on behalf of your company.
+
+### Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these
+terms. If you modify the software, you must include in any modified copies of the software a prominent notice
+stating that you have modified the software.
+
+### No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in these terms.
+
+### Termination
+
+If you use the software in violation of these terms, such use is not licensed, and your license will
+automatically terminate. If the licensor provides you with a notice of your violation, and you cease all
+violation of this license no later than 30 days after you receive that notice, your license will be reinstated
+retroactively. However, if you violate these terms after such reinstatement, any additional violation of these
+terms will cause your license to terminate automatically and permanently.
+
+### No Liability
+
+As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will
+not be liable to you for any damages arising out of these terms or the use or nature of the software, under
+any kind of legal claim.
+
+### Definitions
+
+The "licensor" is the entity offering these terms.
+
+The "software" is the software the licensor makes available under these terms, including any portion of it.
+
+"You" refers to the individual or entity agreeing to these terms.
+
+"Your company" is any legal entity, sole proprietorship, or other kind of organization that you work for, plus
+all organizations that have control over, are under the control of, or are under common control with that
+organization. Control means ownership of substantially all the assets of an entity, or the power to direct its
+management and policies by vote, contract, or otherwise. Control can be direct or indirect.
+
+"Your license" is the license granted to you for the software under these terms.
+
+"Use" means anything you do with the software requiring your license.
+
+"Trademark" means trademarks, service marks, and similar rights.
+
+---
+
+## Acknowledgments
+
+This project contains agent prompts derived from [oh-my-opencode](https://github.com/nicepkg/opencode),
+which uses the Sustainable Use License. We acknowledge the original work and comply with its license terms.
+
+This software has been modified from the original oh-my-opencode implementation:
+- Adapted for Claude Code plugin architecture
+- Added multi-provider MCP server support
+- Created original alternative agent prompts
+
+Third-party dependencies are licensed under their respective licenses.

package/README.md

@@ -0,0 +1,288 @@
+# oh-my-claude
+
+[English](README.md) | [中文](README.zh-CN.md)
+
+Multi-provider MCP server for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) with specialized agent workflows.
+
+Route background tasks to multiple AI providers (DeepSeek, ZhiPu GLM, MiniMax) via Anthropic-compatible APIs while leveraging Claude Code's native capabilities.
+
+## Features
+
+- **Multi-Provider MCP Server** - Background task execution with DeepSeek, ZhiPu GLM, MiniMax
+- **Specialized Agent Workflows** - Pre-configured agents for different task types (Sisyphus, Oracle, Librarian, etc.)
+- **Slash Commands** - Quick actions (`/omcx-commit`, `/omcx-implement`) and agent activation (`/omc-sisyphus`, `/omc-plan`)
+- **Planning System** - Strategic planning with Prometheus agent and boulder-state tracking
+- **Official MCP Setup** - One-command installation for Sequential Thinking, MiniMax, and GLM MCPs
+- **Concurrent Execution** - Per-provider rate limiting and parallel task management
+- **Hook Integration** - Code quality checks and todo tracking
+
+## Quick Start
+
+### Prerequisites
+
+- [Bun](https://bun.sh/) runtime
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI installed
+- API keys for providers you want to use
+
+### Installation
+
+```bash
+# Install from npm (recommended)
+npx @lgcyaxi/oh-my-claude install
+
+# Or clone and install locally
+git clone https://github.com/lgcyaxi/oh-my-claude.git
+cd oh-my-claude
+bun install && bun run build:all
+bun run install-local
+```
+
+### Set API Keys
+
+```bash
+# DeepSeek (for Oracle, Explore agents)
+export DEEPSEEK_API_KEY=your-deepseek-api-key
+
+# ZhiPu GLM (for Librarian, Frontend-UI-UX agents)
+export ZHIPU_API_KEY=your-zhipu-api-key
+
+# MiniMax (for Document-Writer agent)
+export MINIMAX_API_KEY=your-minimax-api-key
+```
+
+### Setup Official MCP Servers
+
+```bash
+# Install all official MCP servers (Sequential Thinking, MiniMax, GLM)
+npx @lgcyaxi/oh-my-claude setup-mcp
+
+# Or install specific ones
+npx @lgcyaxi/oh-my-claude setup-mcp --thinking  # Sequential Thinking only
+npx @lgcyaxi/oh-my-claude setup-mcp --minimax   # MiniMax only
+npx @lgcyaxi/oh-my-claude setup-mcp --glm       # GLM/ZhiPu servers only
+
+# List available MCP servers
+npx @lgcyaxi/oh-my-claude setup-mcp --list
+```
+
+### Verify Installation
+
+```bash
+# Check installation status
+npx @lgcyaxi/oh-my-claude status
+
+# Diagnose configuration (with detailed component status)
+npx @lgcyaxi/oh-my-claude doctor --detail
+```
+
+## Slash Commands
+
+### Agent Commands (`/omc-*`)
+
+| Command | Description |
+|---------|-------------|
+| `/omc-sisyphus` | Activate Sisyphus - full implementation orchestrator |
+| `/omc-oracle` | Activate Oracle - deep reasoning and architecture |
+| `/omc-librarian` | Activate Librarian - external research and docs |
+| `/omc-reviewer` | Activate Claude-Reviewer - code review and QA |
+| `/omc-scout` | Activate Claude-Scout - fast exploration |
+| `/omc-explore` | Activate Explore - codebase search |
+| `/omc-plan` | Start strategic planning with Prometheus |
+| `/omc-start-work` | Begin work on an existing plan |
+
+### Quick Action Commands (`/omcx-*`)
+
+| Command | Description |
+|---------|-------------|
+| `/omcx-commit` | Smart git commit with conventional format |
+| `/omcx-implement` | Implement a feature with best practices |
+| `/omcx-refactor` | Refactor code with quality improvements |
+| `/omcx-docs` | Generate or update documentation |
+
+## Agent Workflows
+
+| Agent | Provider | Model | Role |
+|-------|----------|-------|------|
+| **Sisyphus** | Claude (Task tool) | claude-opus-4-5 | Primary orchestrator |
+| **Claude-Reviewer** | Claude (Task tool) | claude-sonnet-4-5 | Code review, QA |
+| **Claude-Scout** | Claude (Task tool) | claude-haiku-4-5 | Fast exploration |
+| **Prometheus** | Claude (Task tool) | claude-opus-4-5 | Strategic planning |
+| **Oracle** | DeepSeek (MCP) | deepseek-reasoner | Deep reasoning |
+| **Librarian** | ZhiPu (MCP) | glm-4.7 | External research |
+| **Explore** | DeepSeek (MCP) | deepseek-chat | Codebase search |
+| **Frontend-UI-UX** | ZhiPu (MCP) | glm-4v-flash | Visual/UI design |
+| **Document-Writer** | MiniMax (MCP) | MiniMax-M2.1 | Documentation |
+
+## Official MCP Servers
+
+The `setup-mcp` command installs these official MCP servers:
+
+| Server | Provider | Description | API Key Required |
+|--------|----------|-------------|------------------|
+| **sequential-thinking** | Anthropic | Structured problem-solving | No |
+| **MiniMax** | MiniMax | Coding plan assistance | MINIMAX_API_KEY |
+| **web-reader** | ZhiPu GLM | Web content extraction | ZHIPU_API_KEY |
+| **web-search-prime** | ZhiPu GLM | Web search | ZHIPU_API_KEY |
+| **zread** | ZhiPu GLM | GitHub repository reader | ZHIPU_API_KEY |
+| **zai-mcp-server** | ZhiPu GLM | Image/video analysis | ZHIPU_API_KEY |
+
+## CLI Commands
+
+```bash
+# Installation
+npx @lgcyaxi/oh-my-claude install              # Install oh-my-claude
+npx @lgcyaxi/oh-my-claude install --force      # Force reinstall
+npx @lgcyaxi/oh-my-claude install --skip-mcp   # Skip MCP server setup
+
+# Status & Diagnostics
+npx @lgcyaxi/oh-my-claude status               # Check installation status
+npx @lgcyaxi/oh-my-claude doctor               # Diagnose configuration
+npx @lgcyaxi/oh-my-claude doctor --detail      # Detailed component status
+npx @lgcyaxi/oh-my-claude doctor --no-color    # Disable colored output
+
+# MCP Server Setup
+npx @lgcyaxi/oh-my-claude setup-mcp            # Install all official MCPs
+npx @lgcyaxi/oh-my-claude setup-mcp --list     # List available MCPs
+npx @lgcyaxi/oh-my-claude setup-mcp --thinking # Sequential Thinking only
+npx @lgcyaxi/oh-my-claude setup-mcp --minimax  # MiniMax only
+npx @lgcyaxi/oh-my-claude setup-mcp --glm      # GLM/ZhiPu servers only
+
+# Uninstall
+npx @lgcyaxi/oh-my-claude uninstall            # Remove oh-my-claude
+npx @lgcyaxi/oh-my-claude uninstall --keep-config  # Keep config file
+```
+
+## Configuration
+
+Configuration file: `~/.claude/oh-my-claude.json`
+
+```json
+{
+  "providers": {
+    "claude": {
+      "type": "claude-subscription",
+      "note": "Uses Claude Code's native subscription"
+    },
+    "deepseek": {
+      "type": "anthropic-compatible",
+      "base_url": "https://api.deepseek.com/anthropic",
+      "api_key_env": "DEEPSEEK_API_KEY"
+    },
+    "zhipu": {
+      "type": "anthropic-compatible",
+      "base_url": "https://open.bigmodel.cn/api/anthropic",
+      "api_key_env": "ZHIPU_API_KEY"
+    },
+    "minimax": {
+      "type": "anthropic-compatible",
+      "base_url": "https://api.minimaxi.com/anthropic",
+      "api_key_env": "MINIMAX_API_KEY"
+    }
+  },
+  "agents": {
+    "Sisyphus": { "provider": "claude", "model": "claude-opus-4-5" },
+    "oracle": { "provider": "deepseek", "model": "deepseek-reasoner" },
+    "librarian": { "provider": "zhipu", "model": "glm-4.7" }
+  },
+  "concurrency": {
+    "default": 5,
+    "per_provider": {
+      "deepseek": 10,
+      "zhipu": 10,
+      "minimax": 5
+    }
+  }
+}
+```
+
+## Architecture
+
+```
+┌──────────────────────────────────────────────────────────────────────────┐
+│                         Claude Code Session                               │
+├──────────────────────────────────────────────────────────────────────────┤
+│  Primary Agent (Claude via Subscription)                                  │
+│         │                                                                 │
+│    ┌────┴────┬─────────────────┐                                         │
+│    ▼         ▼                 ▼                                         │
+│  Task Tool   MCP Server     Hooks                                        │
+│  (sync)      (async)        (lifecycle)                                  │
+│    │           │                │                                        │
+│    ▼           ▼                ▼                                        │
+│  Claude      Multi-Provider  settings.json                               │
+│  Subagents   Router          scripts                                     │
+│                │                                                         │
+│                ├── DeepSeek (Anthropic-compatible)                       │
+│                ├── ZhiPu GLM (Anthropic-compatible)                      │
+│                ├── MiniMax (Anthropic-compatible)                        │
+│                └── OpenRouter (OpenAI-compatible, optional)              │
+└──────────────────────────────────────────────────────────────────────────┘
+```
+
+### Execution Modes
+
+- **Task Tool (sync)**: Claude subscription agents run via Claude Code's native Task tool
+- **MCP Server (async)**: External API agents run via MCP for parallel background execution
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Type checking
+bun run typecheck
+
+# Build everything
+bun run build:all
+
+# Run tests
+bun test
+
+# Install locally for development
+bun run install-local
+```
+
+## Troubleshooting
+
+### "Provider not configured"
+
+Make sure you've set the API key environment variable:
+```bash
+export DEEPSEEK_API_KEY=your-key
+```
+
+### "Agent uses Claude subscription"
+
+Some agents use Claude Code's Task tool, not the MCP server. These run synchronously within Claude Code.
+
+### MCP server not responding
+
+Rebuild the MCP server:
+```bash
+bun run build:mcp
+npx @lgcyaxi/oh-my-claude install --force
+```
+
+### Check detailed status
+
+```bash
+npx @lgcyaxi/oh-my-claude doctor --detail
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+Sustainable Use License - see [LICENSE](LICENSE) for details.
+
+This project contains agent prompts derived from [oh-my-opencode](https://github.com/nicepkg/opencode). Original agent prompts in `src/agents/original/` are available under MIT License.
+
+## Acknowledgments
+
+- Built for [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
+- Uses [Model Context Protocol](https://modelcontextprotocol.io/)
+- Agent workflow concepts from [oh-my-opencode](https://github.com/nicepkg/opencode)
+- Sequential Thinking MCP from [@modelcontextprotocol/server-sequential-thinking](https://www.npmjs.com/package/@modelcontextprotocol/server-sequential-thinking)