CLDCDE - Claude Code Development Environment
The complete productivity suite for Claude Code developers. 40+ CLI shortcuts, real-time context monitoring, and a community platform for extensions and resources.
🌐 Live Platform: https://cldcde.cc
📦 NPM Packages: @aegntic/cldcde-cloud-aegnts ⭐ • @aegntic/cldcde-cli-shortcuts • @aegntic/cldcde-context-tracker
⚡ Quick Start
Install CLI Shortcuts (40+ shortcuts)
npm install -g @aegntic/cldcde-cli-shortcuts
# Automatically configures your shell with shortcuts like cld, cldp, cldc
Install Context Monitor (Real-time token tracking)
npm install -g @aegntic/cldcde-context-tracker
# Shows context usage below Claude input with visual indicators
Most Popular Shortcuts
cld # Start Claude (most important!)
cldp # Print mode (non-interactive)
cldc # Continue conversation
cldr # Resume a session
cld-help # Show all 40+ shortcuts
🎯 CLDCDE Ecosystem
📦 NPM Packages
1. Cloud Aegnts (@aegntic/cldcde-cloud-aegnts) ⭐ NEW
Cursor-inspired Cloud Aegnts with Computer Use - Run aegnts in isolated sandboxes:
- ✅ Isolated sandbox execution (Docker, E2B, VM, Remote)
- ✅ Computer Use: browser & desktop automation
- ✅ Automatic video recording of aegnt interactions
- ✅ Artifact generation (videos, screenshots, logs)
- ✅ Multi-aegnt parallelism (up to 8 aegnts)
- ✅ Merge-ready PRs with demo artifacts
- ✅ Multiplatform: Claude Code, Agent-Zero, OpenCode, OpenClaw
# Installation
npm install -g @aegntic/cldcde-cloud-aegnts
# Quick start - run a cloud aegnt with video recording
cldcde-aegnts start "Build a REST API and test it" --repo=https://github.com/owner/repo
# Multi-aegnt parallel execution
cldcde-aegnts parallel "Build frontend" "Build backend" "Write tests"
2. CLI Shortcuts (@aegntic/cldcde-cli-shortcuts)
40+ battle-tested shortcuts for Claude Code productivity:
- ✅ 30+ aliases like
cld,cldp,cldc,cldr - ✅ 10+ utility functions like
cld-help,cld-auto,cld-quick - ✅ Model shortcuts for Claude 4 Sonnet/Opus
- ✅ Safety features with auto-execute warnings
- ✅ Automatic installation and shell configuration
# Installation
npm install -g @aegntic/cldcde-cli-shortcuts
# Usage examples
cld # Start Claude in current directory
cld-quick "analyze this code" # Quick non-interactive question
cld-auto "review for bugs" # Auto-execute with safety warnings
clds "explain this function" # Use Claude 4 Sonnet specifically
3. Context Tracker (@aegntic/cldcde-context-tracker)
Real-time context window monitor that shows token usage below Claude input:
- ✅ Live token counting as you type
- ✅ Color-coded progress bar (green → yellow → red)
- ✅ Claude 4 optimized (200K token window)
- ✅ Persistent integration via Claude hooks
- ✅ Lightweight with minimal performance impact
# Installation
npm install -g @aegntic/cldcde-context-tracker
# Shows: 1,247 tokens [████████░░░░░░░░░░░░] 6.2%
🌐 CLDCDE.CC Platform
The community hub for Claude Code extensions, MCP servers, and resources:
Core Features
- Extension & MCP Browser: Search, discover, and install tools
- News & Updates: Latest from Anthropic and community innovations
- Documentation Hub: Curated guides and resources
- User Profiles: Share extensions and track contributions
- Theme System: Terminal-inspired dark/light themes
Technology Stack
- Frontend: React + TypeScript on Cloudflare Pages
- Backend: Hono + Cloudflare Workers + Supabase
- Runtime: Bun for faster development
- AI Integration: OpenRouter for content generation
- Database: Supabase (PostgreSQL + Auth)
🏗️ Architecture Overview
CLDCDE Ecosystem
├── NPM Packages
│ ├── @aegntic/cldcde-cloud-aegnts # Cloud Aegnts with Computer Use ⭐
│ ├── @aegntic/cldcde-cli-shortcuts # 40+ Claude CLI shortcuts
│ └── @aegntic/cldcde-context-tracker # Real-time context monitor
├── CLDCDE.CC Platform # Community hub
│ ├── Extension Browser # Discover tools
│ ├── MCP Server Registry # Protocol servers
│ ├── News & Updates # Community content
│ └── Documentation Hub # Resources & guides
└── Development Tools
├── Setup wizards # Automated configuration
├── Monitoring agents # Content aggregation
└── Deployment scripts # Infrastructure automation
🛠️ Development
Prerequisites
- Bun runtime
- Node.js 18+ (for npm packages)
- Cloudflare account (for platform)
- Supabase project (for platform)
Environment Setup
# Clone repository
git clone https://github.com/aegntic/cldcde.git
cd cldcde
# Install dependencies
bun install
# Configure environment
cp .env.example .env
# Edit .env with your API keys
Development Commands
# Platform development
bun dev # Start development server
bun run site:build # Build Cloudflare Pages artifact (.pages-dist)
bun run site:check # Validate deploy artifact
bun run site:preview # Preview website locally on :4173
bun run site:deploy # Deploy frontend to Cloudflare Pages
bunx wrangler deploy -c wrangler.worker.toml # Deploy backend worker
# NPM package development
cd cli-shortcuts/
npm test # Test CLI shortcuts
npm run install-shortcuts # Test installation
cd ../context-tracker/
npm test # Test context monitor
npm run install-addon # Test installation
Website operations runbook: docs/website-operations.md
Project Structure
cldcde/
├── src/ # Platform backend
│ ├── api/ # API endpoints
│ ├── agents/ # Content monitoring
│ ├── db/ # Database connections
│ └── worker-ultra.ts # Main entry point
├── frontend/ # Platform frontend
│ ├── src/components/ # React components
│ ├── src/styles/ # Theme system
│ └── dist/ # Build output
├── cli-shortcuts/ # NPM: CLI shortcuts package
│ ├── shortcuts/ # Shell scripts
│ ├── bin/ # Installation scripts
│ └── test/ # Test suite
├── context-tracker/ # NPM: Context monitor package
│ ├── lib/ # Monitor implementation
│ ├── bin/ # Installation scripts
│ └── README.md # Package documentation
├── supabase/ # Database schemas
├── scripts/ # Setup and deployment
└── content/ # Static content
📝 API Reference
Platform APIs (cldcde.cc)
# Authentication
POST /api/auth/register # User registration
POST /api/auth/login # User login
GET /api/auth/me # Current user
# Extensions & MCP
GET /api/extensions # List extensions
GET /api/mcp # List MCP servers
POST /api/extensions # Create extension (auth)
# Users & Social
GET /api/users/check-username # Username availability
PUT /api/users/profile # Update profile
GET /api/news # News feed
CLI Shortcuts (Node.js API)
import CLIShortcuts from '@aegntic/cldcde-cli-shortcuts';
const shortcuts = new CLIShortcuts();
shortcuts.displayHelp(); // Show all shortcuts
shortcuts.getTotalShortcutsCount(); // Get count (40+)
shortcuts.checkInstallation(); // Verify installation
Context Monitor (Node.js API)
import ContextMonitor from '@aegntic/cldcde-context-tracker';
const monitor = new ContextMonitor();
monitor.estimateTokens(text); // Estimate token count
monitor.display(input); // Show monitor below input
monitor.attachToInput(); // Hook into stdin
🚀 Productivity Tips
Essential Workflow
# 1. Install CLDCDE tools
npm install -g @aegntic/cldcde-cli-shortcuts @aegntic/cldcde-context-tracker
# 2. Start Claude with monitoring
cld # Now includes context tracking
# 3. Quick operations
cld-quick "What's the bug in this function?" # Fast question
cld-auto "analyze this code for improvements" # Safe auto-execute
cldc "continue with the refactoring" # Resume conversation
# 4. Model-specific workflows
clds "write unit tests" # Use Claude 4 Sonnet
cldo "complex architecture" # Use Claude 4 Opus for complex tasks
Power User Features
# JSON output for scripting
cldjson "list all functions" | jq '.functions'
# Streaming for real-time
cldstream "explain this algorithm step by step"
# Session management
cldr # Interactive session picker
cld-session # Alternative session picker
Safety Guidelines
- ✅ Safe for auto-execute: Code analysis, reviews, explanations
- ❌ Avoid auto-execute: File modifications, system commands, deletions
- 💡 Use warnings:
cld-autoshows safety reminders before execution
🎨 Customization
Add Custom Shortcuts
Edit ~/.claude/shortcuts/claude-shortcuts.sh:
# Your personal shortcuts
alias cldwork="claude --add-dir ~/work --model claude-4-sonnet"
alias cldreview="cld-auto 'review this code for bugs'"
Theme Configuration
The platform supports multiple themes:
- Claude Code Dark (default)
- Claude Light (matches Claude.ai)
- Futuristic Monochrome (cyberpunk-inspired)
📊 Impact & Statistics
User Productivity Gains
- ⚡ 3-5x faster Claude workflow with shortcuts
- 🔍 Real-time awareness of context usage
- 📈 40+ shortcuts memorized through daily use
- 🛡️ Safer automation with built-in warnings
Community Growth
- 📦 2 NPM packages published and maintained
- 🌐 Community platform for extensions and tools
- 📚 Documentation hub with curated resources
- 🤝 Open source with MIT license
🔧 Configuration
Shell Integration
Works with all major shells:
- ✅ Bash (automatic configuration)
- ✅ Zsh (automatic configuration)
- ✅ Fish (manual setup available)
- ✅ Any POSIX shell
Claude Code Integration
- Hooks system: Context monitor integrates via Claude hooks
- Resume helper: Improved conversation resuming
- MCP support: Works with all MCP servers
- IDE integration: Supports VS Code, Cursor, and others
🤝 Contributing
We welcome contributions across all CLDCDE projects:
NPM Packages
- CLI Shortcuts: Add new shortcuts to
shortcuts/claude-shortcuts.sh - Context Monitor: Improve token estimation or visual display
- Testing: Add test cases for new features
Platform Development
- Features: New extensions, improved search, better themes
- Content: News aggregation, documentation updates
- Performance: Caching, optimization, monitoring
Contributing Process
# 1. Fork the repository
git clone https://github.com/your-username/cldcde.git
# 2. Create feature branch
git checkout -b feature/amazing-feature
# 3. Make changes and test
npm test # Test packages
bun dev # Test platform
# 4. Submit pull request
git push origin feature/amazing-feature
📈 Roadmap
Short-term (Q1 2025)
- VS Code extension for seamless integration
- Cursor integration with native shortcuts
- Advanced context analysis with file-type awareness
- Team collaboration features for shared shortcuts
Medium-term (Q2 2025)
- AI-powered shortcuts that adapt to usage patterns
- Cross-platform GUI for non-terminal users
- Plugin ecosystem for custom extensions
- Analytics dashboard for productivity tracking
Long-term (2025+)
- Enterprise features for large development teams
- Claude Desktop integration with native APIs
- Multi-model support beyond Claude
- Advanced AI workflows with autonomous agents
🔗 Resources & Links
Official Links
- 🌐 Platform: cldcde.cc
- 📦 CLI Shortcuts: npm.im/@aegntic/cldcde-cli-shortcuts
- 📦 Context Tracker: npm.im/@aegntic/cldcde-context-tracker
- 🐙 GitHub: github.com/aegntic/cldcde
Community
- 💬 Issues: GitHub Issues
- 💡 Discussions: GitHub Discussions
- 📚 Wiki: GitHub Wiki
- 📧 Updates: Newsletter signup on cldcde.cc
Related Projects
- 🤖 Claude Code: claude.ai/code
- 🔌 MCP Servers: Community registry on cldcde.cc
- 🛠️ Developer Tools: Extension marketplace on cldcde.cc
📄 License
MIT License - See LICENSE file for details.
🙏 Acknowledgments
- Anthropic for Claude and Claude Code
- OpenRouter for LLM infrastructure
- Cloudflare for hosting and Workers platform
- Supabase for backend services
- The Claude Code Community for feedback and contributions
- All contributors who help make CLDCDE better
Built with ❤️ for the Claude Code community
Boost your AI development workflow with battle-tested tools used by thousands of developers worldwide.
Updated for Claude 4 - August 2025