{"id":35094098,"url":"https://github.com/maxritter/claude-codepro","last_synced_at":"2026-02-02T10:30:15.992Z","repository":{"id":321415954,"uuid":"1078701786","full_name":"maxritter/claude-codepro","owner":"maxritter","description":"Production-Grade Development Environment for Claude Code. Quality automated. Context optimized. Testing enforced. Ship with confidence. ✔️","archived":false,"fork":false,"pushed_at":"2026-01-28T16:31:43.000Z","size":33754,"stargazers_count":415,"open_issues_count":2,"forks_count":43,"subscribers_count":8,"default_branch":"main","last_synced_at":"2026-01-28T23:44:33.555Z","etag":null,"topics":["ai-agents","ai-assistant","ai-coding","ai-coding-tools","ai-engineering","ai-tools","anthropic","anthropic-claude","claude","claude-ai","claude-code","claude-context","claude-mem","claude-skills","claudecode","mcp","model-context-protocol","software-engineering","spec-driven-development"],"latest_commit_sha":null,"homepage":"https://claude-code.pro","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maxritter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"maxritter"}},"created_at":"2025-10-18T08:30:23.000Z","updated_at":"2026-01-28T22:36:15.000Z","dependencies_parsed_at":"2025-10-29T15:32:48.819Z","dependency_job_id":null,"html_url":"https://github.com/maxritter/claude-codepro","commit_stats":null,"previous_names":["maxritter/claude-code-pro","maxritter/claude-codepro"],"tags_count":217,"template":false,"template_full_name":null,"purl":"pkg:github/maxritter/claude-codepro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxritter%2Fclaude-codepro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxritter%2Fclaude-codepro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxritter%2Fclaude-codepro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxritter%2Fclaude-codepro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maxritter","download_url":"https://codeload.github.com/maxritter/claude-codepro/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxritter%2Fclaude-codepro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29010209,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-02T08:40:12.472Z","status":"ssl_error","status_checked_at":"2026-02-02T08:40:10.926Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-assistant","ai-coding","ai-coding-tools","ai-engineering","ai-tools","anthropic","anthropic-claude","claude","claude-ai","claude-code","claude-context","claude-mem","claude-skills","claudecode","mcp","model-context-protocol","software-engineering","spec-driven-development"],"created_at":"2025-12-27T15:04:24.311Z","updated_at":"2026-02-02T10:30:15.985Z","avatar_url":"https://github.com/maxritter.png","language":"TypeScript","readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"docs/img/logo.png\" alt=\"Claude CodePro\" width=\"400\"\u003e\n\n### Production-Grade Development Environment for Claude Code\n\nQuality automated. Context optimized. Testing enforced. Ship with confidence.\u003c/br\u003e\nA shortcut to state-of-the-art Claude Code development, continuously improved.\n\n[![Version](https://img.shields.io/github/v/release/maxritter/claude-codepro?label=Version\u0026color=orange)](https://github.com/maxritter/claude-codepro/releases)\n[![Stars](https://img.shields.io/github/stars/maxritter/claude-codepro?style=flat\u0026color=yellow)](https://github.com/maxritter/claude-codepro/stargazers)\n[![Last Commit](https://img.shields.io/github/last-commit/maxritter/claude-codepro?color=blue)](https://github.com/maxritter/claude-codepro/commits/main)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/maxritter/claude-codepro/pulls)\n\n#### ⭐ [Star this repository](https://github.com/maxritter/claude-codepro) · 🌐 [Visit the website](https://claude-code.pro) · 🔔 [Follow for updates](https://www.linkedin.com/in/rittermax/)\n\n\u003cbr\u003e\n\n\u003cimg src=\"docs/img/demo.gif\" alt=\"Claude CodePro Demo\" width=\"800\"\u003e\n\n\u003c/div\u003e\n\n---\n\n## ⚡ TL;DR\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/maxritter/claude-codepro/v5.4.12/install.sh | bash\n```\n\nThen run `ccp` in your terminal to start Claude Code, and type `/sync` inside the session to sync rules and skills. Use `/spec` for Spec-Driven Development or Quick Mode for fast fixes.\n\n---\n\n## 📑 Table of Contents\n\n- [Getting Started](#-getting-started)\n- [What's Inside](#-whats-inside)\n- [Why Claude CodePro?](#-why-claude-codepro)\n- [Usage](#-usage)\n- [Contributing](#-contributing)\n- [License](#-license)\n\n---\n\n## 🚀 Getting Started\n\n### ✅ Prerequisites\n\n🖥️ **Platforms:** macOS, Linux, Windows (WSL2)\n\n💳 **Claude:** [Max](https://www.anthropic.com/max), [Team](https://claude.com/pricing/team), or [Enterprise](https://www.anthropic.com/enterprise) recommended\n\nChoose your installation method:\n\n**Option A: 🐳 Dev Container (Recommended)**\n\nPre-configured, isolated environment with all tools ready. No system conflicts, consistent across machines, easy cleanup.\n\n- **Container Runtime** - [Docker Desktop](https://www.docker.com/products/docker-desktop) or compatible equivalent\n- **IDE with Dev Container Support** - Any IDE supporting the [Dev Container spec](https://containers.dev/):\n  - VS Code and forks: [VS Code](https://code.visualstudio.com/), [Cursor](https://cursor.sh/), [Windsurf](https://windsurf.com/), [Antigravity](https://antigravity.google/) (with [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers))\n  - JetBrains IDEs: [IntelliJ IDEA](https://www.jetbrains.com/help/idea/connect-to-devcontainer.html), WebStorm, PyCharm, GoLand, etc.\n  - Cloud: [GitHub Codespaces](https://github.com/features/codespaces), [DevPod](https://devpod.sh/), [CodeSandbox](https://codesandbox.io/)\n\n**Option B: 🍺 Local Installation**\n\nInstall directly on your system. Requires Homebrew (macOS/Linux/WSL2).\n\n### 🔧 Installation\n\nRun the following command in your **project folder root**:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/maxritter/claude-codepro/v5.4.12/install.sh | bash\n```\n\nYou'll be asked to choose between **Dev Container** or **Local Installation**.\n\n---\n\n## 📦 What's Inside\n\n### ♾️ Endless Mode\n\n- **Seamless Continuity** - Work on complex features across multiple sessions without losing progress\n- **Automatic Handoffs** - Context Monitor detects limits and continues seamlessly in new sessions\n- **Persistent Memory** - Relevant observations automatically carry across all sessions\n- **Works Everywhere** - Both `/spec` workflow and Quick Mode benefit from session continuity\n\n### 📋 Spec-Driven Development\n\n- **Planning** - Creates a detailed implementation plan for your review as markdown in `docs/plans/`\n- **Approval** - You review, edit if needed, and approve the plan before implementation\n- **Implementation** - Executes the plan with TDD enforcement and context management\n- **Verification** - Runs tests, quality checks, and validates completion based on the plan\n\n### 📚 Modular Rules, Commands \u0026 Skills\n\n- **Rules** - Best practices for TDD, debugging, context management, and more\n- **Commands** - `/spec` for SDD, `/sync` for updating rules, `/learn` for online learning\n- **Skills** - Coding standards for Python, TypeScript, Go, testing, and components\n- **Online Learning** - Automatically extracts reusable workflows and solutions into skills\n- **Customizable** - Add your own rules, commands, and skills that survive updates\n\n### 🧠 Enhanced Context Capabilities\n\n- **Persistent Memory** - Cross-session memory system that automatically ingests context\n- **Semantic Search** - Local vector store based semantic code search for token-efficient retrieval\n- **External Context** - Library docs via Context7, web search and scraping via MCP tools\n- **Browser Automation** - E2E UI testing with headless browser for frontend verification\n\n### ✅ Quality Automation\n\n- **TDD Enforcer** - Pre-edit hook that warns when modifying code without failing tests first\n- **Quality Hooks** - Language-specific hooks for Python, TypeScript and Go that auto-fix issues\n- **LSP Integration** - Language servers installed for real-time diagnostics and go-to-definitions\n- **Status Line** - Live display of context usage, memory status, usage limits, and license info\n\n### 🛠️ One-Command Installer\n\n- **Automated Container Setup** - Isolated Linux environment with pre-configured tools and extensions\n- **Extended Language Support** - Optionally install extended support for Python, TypeScript \u0026 Go\n- **Automated Updater** - Updates CCP to the latest version when launched over the binary\n- **Shell Integration** - Auto-configures bash, fish and zsh with `ccp` alias\n\n---\n\n## 🔄 Why Claude CodePro?\n\nSame task. Different results.\n\n| Ad-hoc Prompting                 | With Claude CodePro                                   |\n| -------------------------------- | ----------------------------------------------------- |\n| ❌ Writes code without tests     | ✅ TDD enforced — tests first, then implementation    |\n| ❌ No quality checks             | ✅ Auto-formatted, linted, type-checked on every edit |\n| ❌ Inconsistent workflow         | ✅ Structured Plan → Implement → Verify cycle         |\n| ❌ Context lost between sessions | ✅ Persistent memory carries observations forward     |\n| ❌ No codebase awareness         | ✅ Semantic search understands your code              |\n| ❌ Hope it works                 | ✅ Verified before marked complete                    |\n\n**The result:** Production-grade code you can ship with confidence. Systematic. Tested. Verified.\n\n---\n\n## ⚡ Usage\n\n### 🔄 Sync Rules \u0026 Skills\n\nRun `/sync` to sync custom rules and skills with your codebase. Run it once initially, then anytime after major changes:\n\n```bash\nccp\n\u003e /sync\n```\n\n### 📋 Spec-Driven Mode\n\nBest for complex features, refactoring, or when you want to review a plan before implementation:\n\n```bash\nccp\n\u003e /spec \"Add user authentication with OAuth and JWT tokens\"\n```\n\n**How it works:**\n\n```\n📋 Plan  →  ✅ Approve  →  🔨 Implement  →  🔍 Verify\n                                ↑              ↓\n                                └── 🔄 Loop ───┘\n```\n\n1. **📋 Plan** — Explores codebase, asks clarifying questions, writes spec to `docs/plans/`\n2. **✅ Approve** — You review and edit the plan, then approve\n3. **🔨 Implement** — Executes each task with TDD and quality hooks\n4. **🔍 Verify** — Runs tests and checks; loops back if issues found\n\n### 💬 Quick Mode\n\nJust chat. No plan file, no approval gate. All quality hooks and TDD enforcement still apply.\n\nBest for bug fixes, small improvements, and exploratory work:\n\n```bash\nccp\n\u003e Fix the null pointer bug in user.py\n```\n\n### 🧠 Online Learning\n\nCapture non-obvious discoveries as reusable skills. Automatically prompted by the context monitor, or invoke manually:\n\n```bash\nccp\n\u003e /learn \"Extract the debugging workflow we used for the race condition\"\n```\n\n### 📐 Rules, Commands \u0026 Skills\n\nClaude CodePro extends Claude Code with a modular system of rules, commands, and skills:\n\n**Managed by CCP** (updated on install):\n\n- `.claude/commands/` - `spec` and `sync` commands are managed by CCP\n- `.claude/rules/standard/` - Best practices and workflows\n- `.claude/ccp/skills/` - Coding standards for languages and frameworks\n\n**Yours to customize** (never touched by updates):\n\n- `.claude/commands/` - Any command besides the standard ones\n- `.claude/rules/custom/` - Project-specific rules\n- `.claude/skills/` - Any skill besides the standards-* from CCP plugin\n\n**When to use what:**\n\n| Type         | Loaded                            | Best for                                |\n| ------------ | --------------------------------- | --------------------------------------- |\n| **Rules**    | Every session (always in context) | Guidelines Claude should always follow  |\n| **Commands** | On demand via `/command`          | Specific workflows or multi-step tasks  |\n| **Skills**   | Dynamically when relevant         | Specialized knowledge, coding standards |\n\n### 🔌 Custom MCP Servers\n\nAdd your own MCP servers in two locations:\n\n| Config File | How It Works | Best For |\n|-------------|--------------|----------|\n| `.mcp.json` | Instructions load into context when triggered | Lightweight servers (few tools) |\n| `mcp_servers.json` | Called via mcp-cli; instructions never enter context | Heavy servers (many tools) |\n\nRun `/sync` after adding servers to generate documentation.\n\n---\n\n## 🤝 Contributing\n\n**Pull Requests** - New features, improvements, and bug fixes are welcome. Fun fact: CCP is built with CCP — a self-improving loop where your contributions make the tool that makes contributions better. 🔄\n\n**Issues** - Found a bug or have a feature request? [Open an issue](https://github.com/maxritter/claude-codepro/issues).\n\n---\n\n## 📄 License\n\n\u003e **Try free for 7 days** — No signup, no credit card. Just install and go.\n\n**Why subscribe?** Claude CodePro is actively developed with daily usage in production environments. Your subscription gives you instant access to the latest best practices, workflows, and learnings — a shortcut to state-of-the-art Claude Code development without spending weeks figuring it out yourself.\n\nAfter your trial, choose the tier that fits your needs [here](https://license.claude-code.pro):\n\n| Tier | Includes |\n|:-----|:---------|\n| **Standard** | All features, continuous updates with latest learnings, GitHub support |\n| **Enterprise** | Standard + dedicated email support and priority feature requests |\n\nSee the [LICENSE](LICENSE) file for full terms.\n","funding_links":["https://github.com/sponsors/maxritter"],"categories":["📚 Projects (1974 total)","Workflows \u0026 Knowledge Guides 🧠","MCP Servers"],"sub_categories":["MCP Servers","General","Software Development"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxritter%2Fclaude-codepro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaxritter%2Fclaude-codepro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxritter%2Fclaude-codepro/lists"}