{"id":29431944,"url":"https://github.com/aegntic/cldcde","last_synced_at":"2026-04-10T02:42:21.365Z","repository":{"id":304049226,"uuid":"1010916872","full_name":"aegntic/cldcde","owner":"aegntic","description":"The unofficial community hub for Claude Code extensions and MCP servers","archived":false,"fork":false,"pushed_at":"2025-07-10T20:54:48.000Z","size":1403,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-11T02:48:23.559Z","etag":null,"topics":["bun","claude-code","cloudflare-workers","extensions","hono","mcp","news-aggregator","openrouter","react","supabase","terminal-ui","typescript"],"latest_commit_sha":null,"homepage":null,"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/aegntic.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}},"created_at":"2025-06-30T03:16:45.000Z","updated_at":"2025-07-10T20:54:51.000Z","dependencies_parsed_at":"2025-07-11T02:48:32.570Z","dependency_job_id":"4b4fcda4-7e8b-49b0-82fb-63d5fb14947d","html_url":"https://github.com/aegntic/cldcde","commit_stats":null,"previous_names":["aegntic/cldcde"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/aegntic/cldcde","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aegntic%2Fcldcde","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aegntic%2Fcldcde/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aegntic%2Fcldcde/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aegntic%2Fcldcde/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aegntic","download_url":"https://codeload.github.com/aegntic/cldcde/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aegntic%2Fcldcde/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265054223,"owners_count":23704244,"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","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":["bun","claude-code","cloudflare-workers","extensions","hono","mcp","news-aggregator","openrouter","react","supabase","terminal-ui","typescript"],"created_at":"2025-07-12T21:01:29.493Z","updated_at":"2026-04-10T02:42:21.353Z","avatar_url":"https://github.com/aegntic.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CLDCDE - Claude Code Development Environment\n\nThe complete productivity suite for Claude Code developers. **40+ CLI shortcuts**, **real-time context monitoring**, and a community platform for extensions and resources.\n\n🌐 **Live Platform**: [https://cldcde.cc](https://cldcde.cc)  \n📦 **NPM Packages**: [@aegntic/cldcde-cloud-aegnts](https://npm.im/@aegntic/cldcde-cloud-aegnts) ⭐ • [@aegntic/cldcde-cli-shortcuts](https://npm.im/@aegntic/cldcde-cli-shortcuts) • [@aegntic/cldcde-context-tracker](https://npm.im/@aegntic/cldcde-context-tracker)\n\n## ⚡ Quick Start\n\n### Install CLI Shortcuts (40+ shortcuts)\n```bash\nnpm install -g @aegntic/cldcde-cli-shortcuts\n# Automatically configures your shell with shortcuts like cld, cldp, cldc\n```\n\n### Install Context Monitor (Real-time token tracking)\n```bash\nnpm install -g @aegntic/cldcde-context-tracker\n# Shows context usage below Claude input with visual indicators\n```\n\n### Most Popular Shortcuts\n```bash\ncld              # Start Claude (most important!)\ncldp             # Print mode (non-interactive)\ncldc             # Continue conversation  \ncldr             # Resume a session\ncld-help         # Show all 40+ shortcuts\n```\n\n## 🎯 CLDCDE Ecosystem\n\n### 📦 NPM Packages\n\n#### 1. Cloud Aegnts (`@aegntic/cldcde-cloud-aegnts`) ⭐ NEW\n**Cursor-inspired Cloud Aegnts with Computer Use** - Run aegnts in isolated sandboxes:\n- ✅ **Isolated sandbox execution** (Docker, E2B, VM, Remote)\n- ✅ **Computer Use**: browser \u0026 desktop automation\n- ✅ **Automatic video recording** of aegnt interactions\n- ✅ **Artifact generation** (videos, screenshots, logs)\n- ✅ **Multi-aegnt parallelism** (up to 8 aegnts)\n- ✅ **Merge-ready PRs** with demo artifacts\n- ✅ **Multiplatform**: Claude Code, Agent-Zero, OpenCode, OpenClaw\n\n```bash\n# Installation\nnpm install -g @aegntic/cldcde-cloud-aegnts\n\n# Quick start - run a cloud aegnt with video recording\ncldcde-aegnts start \"Build a REST API and test it\" --repo=https://github.com/owner/repo\n\n# Multi-aegnt parallel execution\ncldcde-aegnts parallel \"Build frontend\" \"Build backend\" \"Write tests\"\n```\n\n#### 2. CLI Shortcuts (`@aegntic/cldcde-cli-shortcuts`)\n**40+ battle-tested shortcuts** for Claude Code productivity:\n- ✅ **30+ aliases** like `cld`, `cldp`, `cldc`, `cldr`\n- ✅ **10+ utility functions** like `cld-help`, `cld-auto`, `cld-quick`\n- ✅ **Model shortcuts** for Claude 4 Sonnet/Opus\n- ✅ **Safety features** with auto-execute warnings\n- ✅ **Automatic installation** and shell configuration\n\n```bash\n# Installation\nnpm install -g @aegntic/cldcde-cli-shortcuts\n\n# Usage examples\ncld                           # Start Claude in current directory\ncld-quick \"analyze this code\" # Quick non-interactive question\ncld-auto \"review for bugs\"    # Auto-execute with safety warnings\nclds \"explain this function\"  # Use Claude 4 Sonnet specifically\n```\n\n#### 3. Context Tracker (`@aegntic/cldcde-context-tracker`)\n**Real-time context window monitor** that shows token usage below Claude input:\n- ✅ **Live token counting** as you type\n- ✅ **Color-coded progress bar** (green → yellow → red)\n- ✅ **Claude 4 optimized** (200K token window)\n- ✅ **Persistent integration** via Claude hooks\n- ✅ **Lightweight** with minimal performance impact\n\n```bash\n# Installation\nnpm install -g @aegntic/cldcde-context-tracker\n\n# Shows: 1,247 tokens [████████░░░░░░░░░░░░] 6.2%\n```\n\n### 🌐 CLDCDE.CC Platform\nThe **community hub** for Claude Code extensions, MCP servers, and resources:\n\n#### Core Features\n- **Extension \u0026 MCP Browser**: Search, discover, and install tools\n- **News \u0026 Updates**: Latest from Anthropic and community innovations  \n- **Documentation Hub**: Curated guides and resources\n- **User Profiles**: Share extensions and track contributions\n- **Theme System**: Terminal-inspired dark/light themes\n\n#### Technology Stack\n- **Frontend**: React + TypeScript on Cloudflare Pages\n- **Backend**: Hono + Cloudflare Workers + Supabase\n- **Runtime**: Bun for faster development\n- **AI Integration**: OpenRouter for content generation\n- **Database**: Supabase (PostgreSQL + Auth)\n\n## 🏗️ Architecture Overview\n\n```\nCLDCDE Ecosystem\n├── NPM Packages\n│   ├── @aegntic/cldcde-cloud-aegnts      # Cloud Aegnts with Computer Use ⭐\n│   ├── @aegntic/cldcde-cli-shortcuts     # 40+ Claude CLI shortcuts\n│   └── @aegntic/cldcde-context-tracker   # Real-time context monitor\n├── CLDCDE.CC Platform                    # Community hub\n│   ├── Extension Browser                 # Discover tools\n│   ├── MCP Server Registry              # Protocol servers\n│   ├── News \u0026 Updates                   # Community content\n│   └── Documentation Hub               # Resources \u0026 guides\n└── Development Tools\n    ├── Setup wizards                    # Automated configuration\n    ├── Monitoring agents               # Content aggregation\n    └── Deployment scripts             # Infrastructure automation\n```\n\n## 🛠️ Development\n\n### Prerequisites\n- [Bun](https://bun.sh) runtime\n- Node.js 18+ (for npm packages)\n- Cloudflare account (for platform)\n- Supabase project (for platform)\n\n### Environment Setup\n```bash\n# Clone repository\ngit clone https://github.com/aegntic/cldcde.git\ncd cldcde\n\n# Install dependencies\nbun install\n\n# Configure environment\ncp .env.example .env\n# Edit .env with your API keys\n```\n\n### Development Commands\n```bash\n# Platform development\nbun dev                      # Start development server\nbun run site:build           # Build Cloudflare Pages artifact (.pages-dist)\nbun run site:check           # Validate deploy artifact\nbun run site:preview         # Preview website locally on :4173\nbun run site:deploy          # Deploy frontend to Cloudflare Pages\nbunx wrangler deploy -c wrangler.worker.toml  # Deploy backend worker\n\n# NPM package development\ncd cli-shortcuts/\nnpm test                     # Test CLI shortcuts\nnpm run install-shortcuts   # Test installation\n\ncd ../context-tracker/\nnpm test                     # Test context monitor\nnpm run install-addon       # Test installation\n```\n\nWebsite operations runbook: `docs/website-operations.md`\n\n### Project Structure\n```\ncldcde/\n├── src/                     # Platform backend\n│   ├── api/                # API endpoints\n│   ├── agents/             # Content monitoring\n│   ├── db/                 # Database connections\n│   └── worker-ultra.ts     # Main entry point\n├── frontend/               # Platform frontend\n│   ├── src/components/     # React components\n│   ├── src/styles/         # Theme system\n│   └── dist/               # Build output\n├── cli-shortcuts/          # NPM: CLI shortcuts package\n│   ├── shortcuts/          # Shell scripts\n│   ├── bin/                # Installation scripts\n│   └── test/               # Test suite\n├── context-tracker/        # NPM: Context monitor package\n│   ├── lib/                # Monitor implementation\n│   ├── bin/                # Installation scripts\n│   └── README.md           # Package documentation\n├── supabase/               # Database schemas\n├── scripts/                # Setup and deployment\n└── content/                # Static content\n```\n\n## 📝 API Reference\n\n### Platform APIs (cldcde.cc)\n```bash\n# Authentication\nPOST /api/auth/register      # User registration\nPOST /api/auth/login         # User login\nGET  /api/auth/me           # Current user\n\n# Extensions \u0026 MCP\nGET  /api/extensions        # List extensions\nGET  /api/mcp              # List MCP servers\nPOST /api/extensions       # Create extension (auth)\n\n# Users \u0026 Social\nGET  /api/users/check-username  # Username availability\nPUT  /api/users/profile         # Update profile\nGET  /api/news                  # News feed\n```\n\n### CLI Shortcuts (Node.js API)\n```javascript\nimport CLIShortcuts from '@aegntic/cldcde-cli-shortcuts';\n\nconst shortcuts = new CLIShortcuts();\nshortcuts.displayHelp();           // Show all shortcuts\nshortcuts.getTotalShortcutsCount(); // Get count (40+)\nshortcuts.checkInstallation();     // Verify installation\n```\n\n### Context Monitor (Node.js API)\n```javascript\nimport ContextMonitor from '@aegntic/cldcde-context-tracker';\n\nconst monitor = new ContextMonitor();\nmonitor.estimateTokens(text);  // Estimate token count\nmonitor.display(input);        // Show monitor below input\nmonitor.attachToInput();       // Hook into stdin\n```\n\n## 🚀 Productivity Tips\n\n### Essential Workflow\n```bash\n# 1. Install CLDCDE tools\nnpm install -g @aegntic/cldcde-cli-shortcuts @aegntic/cldcde-context-tracker\n\n# 2. Start Claude with monitoring\ncld  # Now includes context tracking\n\n# 3. Quick operations\ncld-quick \"What's the bug in this function?\"     # Fast question\ncld-auto \"analyze this code for improvements\"    # Safe auto-execute\ncldc \"continue with the refactoring\"            # Resume conversation\n\n# 4. Model-specific workflows\nclds \"write unit tests\"      # Use Claude 4 Sonnet\ncldo \"complex architecture\"  # Use Claude 4 Opus for complex tasks\n```\n\n### Power User Features\n```bash\n# JSON output for scripting\ncldjson \"list all functions\" | jq '.functions'\n\n# Streaming for real-time\ncldstream \"explain this algorithm step by step\"\n\n# Session management\ncldr                         # Interactive session picker\ncld-session                  # Alternative session picker\n```\n\n### Safety Guidelines\n- ✅ **Safe for auto-execute**: Code analysis, reviews, explanations\n- ❌ **Avoid auto-execute**: File modifications, system commands, deletions\n- 💡 **Use warnings**: `cld-auto` shows safety reminders before execution\n\n## 🎨 Customization\n\n### Add Custom Shortcuts\nEdit `~/.claude/shortcuts/claude-shortcuts.sh`:\n```bash\n# Your personal shortcuts\nalias cldwork=\"claude --add-dir ~/work --model claude-4-sonnet\"\nalias cldreview=\"cld-auto 'review this code for bugs'\"\n```\n\n### Theme Configuration\nThe platform supports multiple themes:\n- **Claude Code Dark** (default)\n- **Claude Light** (matches Claude.ai)\n- **Futuristic Monochrome** (cyberpunk-inspired)\n\n## 📊 Impact \u0026 Statistics\n\n### User Productivity Gains\n- ⚡ **3-5x faster** Claude workflow with shortcuts\n- 🔍 **Real-time awareness** of context usage\n- 📈 **40+ shortcuts** memorized through daily use\n- 🛡️ **Safer automation** with built-in warnings\n\n### Community Growth\n- 📦 **2 NPM packages** published and maintained\n- 🌐 **Community platform** for extensions and tools\n- 📚 **Documentation hub** with curated resources\n- 🤝 **Open source** with MIT license\n\n## 🔧 Configuration\n\n### Shell Integration\nWorks with all major shells:\n- ✅ **Bash** (automatic configuration)\n- ✅ **Zsh** (automatic configuration)\n- ✅ **Fish** (manual setup available)\n- ✅ **Any POSIX shell**\n\n### Claude Code Integration\n- **Hooks system**: Context monitor integrates via Claude hooks\n- **Resume helper**: Improved conversation resuming\n- **MCP support**: Works with all MCP servers\n- **IDE integration**: Supports VS Code, Cursor, and others\n\n## 🤝 Contributing\n\nWe welcome contributions across all CLDCDE projects:\n\n### NPM Packages\n1. **CLI Shortcuts**: Add new shortcuts to `shortcuts/claude-shortcuts.sh`\n2. **Context Monitor**: Improve token estimation or visual display\n3. **Testing**: Add test cases for new features\n\n### Platform Development\n1. **Features**: New extensions, improved search, better themes\n2. **Content**: News aggregation, documentation updates\n3. **Performance**: Caching, optimization, monitoring\n\n### Contributing Process\n```bash\n# 1. Fork the repository\ngit clone https://github.com/your-username/cldcde.git\n\n# 2. Create feature branch\ngit checkout -b feature/amazing-feature\n\n# 3. Make changes and test\nnpm test                    # Test packages\nbun dev                     # Test platform\n\n# 4. Submit pull request\ngit push origin feature/amazing-feature\n```\n\n## 📈 Roadmap\n\n### Short-term (Q1 2025)\n- [ ] **VS Code extension** for seamless integration\n- [ ] **Cursor integration** with native shortcuts\n- [ ] **Advanced context analysis** with file-type awareness\n- [ ] **Team collaboration** features for shared shortcuts\n\n### Medium-term (Q2 2025)\n- [ ] **AI-powered shortcuts** that adapt to usage patterns\n- [ ] **Cross-platform GUI** for non-terminal users\n- [ ] **Plugin ecosystem** for custom extensions\n- [ ] **Analytics dashboard** for productivity tracking\n\n### Long-term (2025+)\n- [ ] **Enterprise features** for large development teams\n- [ ] **Claude Desktop integration** with native APIs\n- [ ] **Multi-model support** beyond Claude\n- [ ] **Advanced AI workflows** with autonomous agents\n\n## 🔗 Resources \u0026 Links\n\n### Official Links\n- 🌐 **Platform**: [cldcde.cc](https://cldcde.cc)\n- 📦 **CLI Shortcuts**: [npm.im/@aegntic/cldcde-cli-shortcuts](https://npm.im/@aegntic/cldcde-cli-shortcuts)\n- 📦 **Context Tracker**: [npm.im/@aegntic/cldcde-context-tracker](https://npm.im/@aegntic/cldcde-context-tracker)\n- 🐙 **GitHub**: [github.com/aegntic/cldcde](https://github.com/aegntic/cldcde)\n\n### Community\n- 💬 **Issues**: [GitHub Issues](https://github.com/aegntic/cldcde/issues)\n- 💡 **Discussions**: [GitHub Discussions](https://github.com/aegntic/cldcde/discussions)\n- 📚 **Wiki**: [GitHub Wiki](https://github.com/aegntic/cldcde/wiki)\n- 📧 **Updates**: [Newsletter signup on cldcde.cc](https://cldcde.cc)\n\n### Related Projects\n- 🤖 **Claude Code**: [claude.ai/code](https://claude.ai/code)\n- 🔌 **MCP Servers**: Community registry on cldcde.cc\n- 🛠️ **Developer Tools**: Extension marketplace on cldcde.cc\n\n## 📄 License\n\nMIT License - See [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- **Anthropic** for Claude and Claude Code\n- **OpenRouter** for LLM infrastructure  \n- **Cloudflare** for hosting and Workers platform\n- **Supabase** for backend services\n- **The Claude Code Community** for feedback and contributions\n- **All contributors** who help make CLDCDE better\n\n---\n\n**Built with ❤️ for the Claude Code community**\n\n*Boost your AI development workflow with battle-tested tools used by thousands of developers worldwide.*\n\n**Updated for Claude 4 - August 2025**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faegntic%2Fcldcde","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faegntic%2Fcldcde","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faegntic%2Fcldcde/lists"}