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-auto shows 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

Name		Name	Last commit message	Last commit date
Latest commit History 57 Commits
.claude-flow/metrics		.claude-flow/metrics
.claude-plugin		.claude-plugin
.claude		.claude
.github/workflows		.github/workflows
.swarm		.swarm
aegntic-hive-mcp		aegntic-hive-mcp
cli-shortcuts		cli-shortcuts
content		content
context-tracker		context-tracker
docs		docs
frontend		frontend
mcp-servers		mcp-servers
memre		memre
migrations		migrations
monitoring		monitoring
plugins		plugins
private		private
public		public
scripts		scripts
skills		skills
src		src
supabase		supabase
templates/claude-md		templates/claude-md
website		website
.env.example		.env.example
.gitignore		.gitignore
BRANDING_GUIDELINES.md		BRANDING_GUIDELINES.md
CHECKPOINT_2025-11-20.md		CHECKPOINT_2025-11-20.md
CLAUDE.md		CLAUDE.md
CLAUDE_CLI_SHORTCUTS.md		CLAUDE_CLI_SHORTCUTS.md
CONTRIBUTING.md		CONTRIBUTING.md
CRITICAL_ANALYSIS.md		CRITICAL_ANALYSIS.md
CRITICAL_ANALYSIS_PREMIUM_SYSTEMS.md		CRITICAL_ANALYSIS_PREMIUM_SYSTEMS.md
D1_MIGRATION_GUIDE.md		D1_MIGRATION_GUIDE.md
DEPLOYMENT-SUMMARY.md		DEPLOYMENT-SUMMARY.md
DEPLOYMENT-ULTRA.md		DEPLOYMENT-ULTRA.md
DEPLOYMENT-V2.md		DEPLOYMENT-V2.md
DEPLOYMENT.md		DEPLOYMENT.md
FEATURED-RESOURCES.md		FEATURED-RESOURCES.md
GH_CLI_AUTH.md		GH_CLI_AUTH.md
GITHUB_SETUP.md		GITHUB_SETUP.md
INTEGRATION.md		INTEGRATION.md
LICENSE		LICENSE
PLAN.md		PLAN.md
PORKBUN-DNS.md		PORKBUN-DNS.md
README-context-tracker.md		README-context-tracker.md
README.md		README.md
SETUP_GUIDE.md		SETUP_GUIDE.md
STRUCTURE_VERIFICATION.md		STRUCTURE_VERIFICATION.md
SUPABASE-SETUP.md		SUPABASE-SETUP.md
TASKS.md		TASKS.md
bun.lock		bun.lock
check-setup.ts		check-setup.ts
claude-with-monitor.js		claude-with-monitor.js
context-monitor.js		context-monitor.js
context-tracker-package.json		context-tracker-package.json
enable-rls.sql		enable-rls.sql
install-claude-shortcuts.sh		install-claude-shortcuts.sh
memre.zip		memre.zip
package.json		package.json
server.ts		server.ts
setup-wizard-simple.ts		setup-wizard-simple.ts
setup-wizard.ts		setup-wizard.ts
test-register-new.json		test-register-new.json
test-register.json		test-register.json
test-supabase-auth.ts		test-supabase-auth.ts
tsconfig.json		tsconfig.json
update-ascii-headers.ts		update-ascii-headers.ts
wrangler-ultra.toml		wrangler-ultra.toml
wrangler-v2.toml		wrangler-v2.toml
wrangler.worker.toml		wrangler.worker.toml

Folders and files

Latest commit

History

Repository files navigation

CLDCDE - Claude Code Development Environment

⚡ Quick Start

Install CLI Shortcuts (40+ shortcuts)

Install Context Monitor (Real-time token tracking)

Most Popular Shortcuts

🎯 CLDCDE Ecosystem

📦 NPM Packages

1. Cloud Aegnts (@aegntic/cldcde-cloud-aegnts) ⭐ NEW

2. CLI Shortcuts (@aegntic/cldcde-cli-shortcuts)

3. Context Tracker (@aegntic/cldcde-context-tracker)

🌐 CLDCDE.CC Platform

Core Features

Technology Stack

🏗️ Architecture Overview

🛠️ Development

Prerequisites

Environment Setup

Development Commands

Project Structure

📝 API Reference

Platform APIs (cldcde.cc)

CLI Shortcuts (Node.js API)

Context Monitor (Node.js API)

🚀 Productivity Tips

Essential Workflow

Power User Features

Safety Guidelines

🎨 Customization

Add Custom Shortcuts

Theme Configuration

📊 Impact & Statistics

User Productivity Gains

Community Growth

🔧 Configuration

Shell Integration

Claude Code Integration

🤝 Contributing

NPM Packages

Platform Development

Contributing Process

📈 Roadmap

Short-term (Q1 2025)

Medium-term (Q2 2025)

Long-term (2025+)

🔗 Resources & Links

Official Links

Community

Related Projects

📄 License

🙏 Acknowledgments

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 3

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

1. Cloud Aegnts (`@aegntic/cldcde-cloud-aegnts`) ⭐ NEW

2. CLI Shortcuts (`@aegntic/cldcde-cli-shortcuts`)

3. Context Tracker (`@aegntic/cldcde-context-tracker`)

Packages