Thanks to visit codestin.com
Credit goes to github.com

Skip to content

aegntic/cldcde

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

13 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

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-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. 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

2. 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-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 build                    # Build frontend
bun run deploy:pages         # Deploy frontend
bunx wrangler deploy         # Deploy backend

# 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

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

  1. CLI Shortcuts: Add new shortcuts to shortcuts/claude-shortcuts.sh
  2. Context Monitor: Improve token estimation or visual display
  3. Testing: Add test cases for new features

Platform Development

  1. Features: New extensions, improved search, better themes
  2. Content: News aggregation, documentation updates
  3. 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

Community

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