{"id":31033008,"url":"https://github.com/git-on-my-level/zcc","last_synced_at":"2025-09-14T01:04:20.997Z","repository":{"id":304603657,"uuid":"1019286069","full_name":"Git-on-my-level/zcc","owner":"Git-on-my-level","description":"A lightweight Claude Code framework to set up multi-agent workflows, common repetitive tasks, and manage long-running projects","archived":false,"fork":false,"pushed_at":"2025-09-11T11:06:17.000Z","size":1321,"stargazers_count":14,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-11T11:55:24.518Z","etag":null,"topics":["claude","claude-code","coding-agent"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Git-on-my-level.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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}},"created_at":"2025-07-14T05:18:31.000Z","updated_at":"2025-09-11T02:21:14.000Z","dependencies_parsed_at":"2025-09-04T09:52:22.022Z","dependency_job_id":null,"html_url":"https://github.com/Git-on-my-level/zcc","commit_stats":null,"previous_names":["git-on-my-level/memento-protocol","git-on-my-level/zcc"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/Git-on-my-level/zcc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Git-on-my-level%2Fzcc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Git-on-my-level%2Fzcc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Git-on-my-level%2Fzcc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Git-on-my-level%2Fzcc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Git-on-my-level","download_url":"https://codeload.github.com/Git-on-my-level/zcc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Git-on-my-level%2Fzcc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275020409,"owners_count":25391711,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-13T02:00:10.085Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["claude","claude-code","coding-agent"],"created_at":"2025-09-14T01:03:57.122Z","updated_at":"2025-09-14T01:04:20.951Z","avatar_url":"https://github.com/Git-on-my-level.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zcc: The zsh for Claude Code\n\n[![npm version](https://badge.fury.io/js/z-claude-code.svg)](https://badge.fury.io/js/z-claude-code)\n\n**Transform Claude Code from a basic AI assistant into a project-aware, context-intelligent development powerhouse.**\n\n## The Problem\n\nClaude Code breaks down as your codebase grows:\n- 😔 Re-adding the same CLAUDE.md instructions across projects\n- 📝 Claude spams markdown files instead of organized task tracking\n- 🔄 Goes in circles after context compacting, repeating failed approaches\n- 🎭 Copy-pasting roleplay prompts: \"Act as engineer...\" \"Be a reviewer...\"\n\n## The Solution: oh-my-zsh for AI\n\nJust as zsh transformed terminals with themes and plugins, zcc transforms Claude Code with:\n\n```bash\n# Before: Basic Claude Code\n\"Please review my code\"  # Generic responses\n\n# After: With zcc\n/mode reviewer          # Specialized AI personality\n\"Review the auth module\" # Context-aware, focused analysis\n```\n\n## See It In Action\n\n```bash\n# 1. Install (30 seconds)\nnpx zcc init\n\n# 2. Use enhanced features immediately\n/mode architect         # Switch to system design mode\n/ticket create \"Add authentication\"  # Persistent task tracking\n/zcc                    # See project status\n\n# 3. Claude becomes context-aware\n\"Implement the auth feature\"  # Claude knows about your ticket, \n                              # project structure, git status, etc.\n```\n\n## Core Features\n\n| **Feature**        | **What It Does**                                   | **zsh Equivalent** |\n| ------------------ | -------------------------------------------------- | ------------------ |\n| **AI Modes**       | Switch personalities (architect/engineer/reviewer) | Themes             |\n| **Tickets**        | Persistent task tracking across sessions           | tmux sessions      |\n| **External Packs** | Install community packs from GitHub                | oh-my-zsh plugins  |\n| **Fuzzy Matching** | `/mode eng` → finds `engineer`                     | Smart completions  |\n| **Hooks**          | Auto-load context, expand acronyms                 | precmd/preexec     |\n| **Workflows**      | Reusable procedures (review, deploy, audit)        | Functions          |\n| **Agents**         | Specialized tools (research, analysis)             | Plugins            |\n\n## Getting Started\n\n### Installation Options\n\n#### 1. Quick Start (Recommended)\n```bash\n# Interactive setup - choose from available starter packs\nnpx zcc init\n\n# Or install a specific starter pack directly (headless)\nnpx zcc init --pack essentials\nnpx zcc init --pack advanced-code-refactoring\n```\n\n#### 2. Global Installation\n```bash\n# Install globally for use across all projects\nnpm install -g z-claude-code\nzcc init\n```\n\n#### 3. Local Development (From Source)\n```bash\n# Clone and build from source\ngit clone https://github.com/git-on-my-level/zcc.git\ncd zcc\nnpm install\nnpm run build\n\n# Use in your project\ncd /your/project\nnode /path/to/zcc/dist/cli.js init\n```\n\n### Common Setup Scenarios\n\n```bash\n# Essential setup (recommended for new users)\nzcc init --pack essentials\n\n# Advanced code refactoring toolkit\nzcc init --pack advanced-code-refactoring\n\n# Start fresh (overwrite existing)\nzcc init --force\n\n# Automated CI/CD setup\nzcc init --pack essentials --force\n```\n\n## Starter Packs: Ready-to-Use Bundles\n\nGet up and running instantly with curated collections of modes, workflows, and agents:\n\n```bash\n# Interactive pack selection\nnpx zcc init\n\n# Or specify a pack directly\nnpx zcc init --pack frontend-react\n```\n\n### Available Packs\n\n| Pack                          | Description                             | Includes                                                                                                                                                                                                                        |\n| ----------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **essentials**                | Essential setup for general development | Core modes (`autonomous-project-manager`, `engineer`, `architect`, `reviewer`, `ai-debt-maintainer`) + workflows (`review`, `summarize`, `openmemory-setup`) + hooks (routing, git context, project overview, acronym expander) |\n| **advanced-code-refactoring** | AST/semantic refactoring toolkit        | Mode (`refactoring-specialist`) + workflows (`semantic-search`, `safe-refactoring`) + agent (`code-archaeologist`) + hook (`ast-grep-awareness`)                                                                                |\n\n### Coming Soon\n- **backend-api** - RESTful API development\n- **fullstack** - End-to-end development combining frontend and backend capabilities\n\n### Community Packs 🎉 NEW!\n\nInstall packs from external sources like GitHub:\n\n```bash\n# Add a community pack source\nzcc source add awesome-packs --type github --owner community --repo zcc-packs\n\n# Search and install packs\nzcc search react\nzcc add pack react-toolkit\n```\n\n[Learn more about external packs →](docs/external-packs.md)\n\n*Just like oh-my-zsh themes transform your terminal experience, starter packs transform Claude Code for your project type.*\n\n## Daily Workflow\n\n```bash\n# Morning: Architecture \u0026 Planning\n/mode architect\n\"Design the payment system\"\n\n# Afternoon: Implementation  \n/mode engineer\n\"Implement stripe integration\"\n\n# Evening: Review\n/mode reviewer\n\"Check for security issues\"\n\n# Track Everything\n/ticket list                  # See all tasks\n/ticket payment-system        # Load ticket context\n```\n\n## Why It Works\n\n**Problem**: Claude Code loses context and repeats mistakes  \n**Solution**: Persistent tickets + smart hooks = continuous context\n\n**Problem**: Same prompts copy-pasted everywhere  \n**Solution**: Built-in modes with best practices baked in\n\n**Problem**: Scattered markdown files everywhere  \n**Solution**: Organized ticket system with clear status tracking\n\n## Documentation\n\n### Essential Guides\n- 🚀 [Quick Start Guide](docs/QUICK_START.md) - Get running in 5 minutes\n- 🪝 [Hooks Guide](docs/HOOKS_GUIDE.md) - Event-driven automation\n\n### Advanced Topics\n- 🌍 [External Packs](docs/external-packs.md) - Install community packs from GitHub\n- 📖 [API Reference](docs/API.md) - Programmatic usage\n- 🛠️ [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues and solutions\n\n## Examples\n\n### Switch Modes with Fuzzy Matching\n```bash\n/mode arc      # → architect\n/mode eng      # → engineer  \n/mode apm      # → autonomous-project-manager\n```\n\n### Create and Track Tasks\n```bash\n/ticket create \"Add user authentication\"\n/ticket move auth-task in-progress\n/ticket finish auth-task\n```\n\n### Auto-Expand Acronyms\n```bash\nzcc acronym add API \"Application Programming Interface\"\nzcc acronym add DDD \"Domain-Driven Design\"\n# Now Claude automatically understands your project's terminology\n```\n\n## Philosophy\n\nLike zsh enhances bash without replacing it, zcc enhances Claude Code while preserving everything that works. Start simple, add power as needed.\n\n## Coming Soon\n\n- 🌍 **Community Hub**: Share modes and workflows\n- 📝 **~/.zcc/config.yaml**: Global config file (unified structure with project config)\n- 🔌 **Plugin Manager**: Easy install/update (like zplug)\n- 📊 **Analytics**: Track productivity and usage patterns\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=git-on-my-level/zcc\u0026type=Timeline)](https://www.star-history.com/#git-on-my-level/zcc\u0026Timeline)\n\n## Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## Support\n\n- 🐛 [Issues](https://github.com/git-on-my-level/zcc/issues)\n- 💬 [Discussions](https://github.com/git-on-my-level/zcc/discussions)\n- 📖 [Wiki](https://github.com/git-on-my-level/zcc/wiki)\n\n## License\n\nMIT © zcc Contributors\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\u003cstrong\u003e⭐ Star us if this solved your Claude Code problems!\u003c/strong\u003e\u003cbr\u003e\n\u003cem\u003eTransform your AI coding experience in 30 seconds\u003c/em\u003e\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgit-on-my-level%2Fzcc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgit-on-my-level%2Fzcc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgit-on-my-level%2Fzcc/lists"}