@vladimir-ks/claude-context-manager

v0.4.6

Published

14 days ago

Context engineering platform for Claude Code - manage skills, commands, and agents with premium subscription tier

0High
0Medium
0Low

vladimir-ks

claude-code claude anthropic ai-context context-engineering prompt-engineering skills prompts cli artifact-manager

Claude Context Manager

Context engineering platform for Claude Code - manage skills, commands, and agents with ease

What is Claude Context Manager?

A comprehensive platform for discovering, installing, and managing Claude Code artifacts (skills, commands, agents) with a freemium model:

Free Tier: Core essentials including the powerful managing-claude-context skill
Premium Tier ($9/month): Professional-grade skills, commands, and priority support
Team Tier ($29/month): Everything in Premium + team collaboration features

Author: Vladimir K.S.

Features

✨ Core Capabilities

Easy Installation - Install artifacts globally or per-project via CLI
Artifact Management - Update, remove, and track installed artifacts
Premium Access - Unlock professional packages with a subscription
Context Engineering - Master skill for creating your own artifacts
Cross-Platform - Works on macOS, Linux, and Windows

🎯 Included Free Tier

managing-claude-context skill - Master skill for AI context engineering
- Create custom skills, commands, and agents
- Progressive disclosure architecture
- Zero-redundancy enforcement
- Complete documentation and references (~5,500 lines)
14+ commands - Context management and workflow tools
AI Logging System - Track AI task execution
Complete documentation - Specifications, guides, examples

💎 Premium Tier (Coming Q1 2025)

Advanced PDF processing with OCR
Enterprise automation workflows
Data analysis tools
AI code review
Priority support and updates

Installation

Method 1: NPM Package (Recommended)

# Install globally
npm install -g @vladks/claude-context-manager

# Verify installation
ccm --version

# Get started
ccm --help

Method 2: Claude Code Plugin

# In Claude Code CLI
/plugin install managing-claude-context@vladks-marketplace

Method 3: Manual Installation

# Clone repository
git clone https://github.com/vladks/claude-context-manager.git

# Copy artifacts to Claude Code directory
cp -r .claude/skills/managing-claude-context ~/.claude/skills/

Quick Start

1. Install Core Essentials

# Install globally (available in all projects)
ccm install --package core-essentials --global

# Or install to specific project
cd /path/to/your/project
ccm install --package core-essentials --project

2. List Available Artifacts

# See what's available
ccm list

# View only premium tier (requires license)
ccm list --tier premium

3. Check Installation Status

# View global installations
ccm status --global

# View project-specific installations
ccm status --project

4. Activate Premium (Optional)

# Activate premium license
ccm activate YOUR_LICENSE_KEY

# Now access premium artifacts
ccm install --skill advanced-pdf --global

Usage Examples

Managing Artifacts

# Install specific skill
ccm install --skill managing-claude-context --global

# Install solution package
ccm install --package core-essentials --global

# Update all installed artifacts
ccm update --global

# Remove artifact
ccm remove --skill managing-claude-context --global

# Search for artifacts
ccm search "pdf"

Project Initialization

# Initialize Claude Code setup in current project
cd /path/to/project
ccm init

# Installs recommended packages and creates .claude/ directory

Using the `managing-claude-context` Skill

Once installed, use the skill in Claude Code:

1. Load skill: Use Skill tool with "managing-claude-context"
2. Choose command: /managing-claude-context:create-edit-skill
3. Provide briefing: See skill manuals for format
4. Review output: Validate generated artifact
5. Test and use: Manual validation, then deploy

Learn More:

Premium Subscription

Pricing

| Tier | Price | Features | | -------------- | --------- | ---------------------------------------- | | Free | $0 | Core essentials, community support | | Premium | $9/month | Professional artifacts, priority support | | Team | $29/month | Premium + team features (5 users) | | Enterprise | Custom | Custom packages, SLA, dedicated support |

Premium Benefits

Access to professional-grade skills and commands
Priority support channel
Regular updates with new packages
Advanced features (OCR, automation, analytics)
Curated, tested, enterprise-ready artifacts

Subscribe: Coming Q1 2025 Early Access: Contact [email protected]

Repository Structure

claude-context-manager/
├── .claude/                          # Free tier artifacts (bundled)
│   ├── skills/
│   │   └── managing-claude-context/  # Core essential skill
│   └── commands/
│       └── managing-claude-context/  # 14+ commands
│
├── bin/                              # CLI entry point
│   └── claude-context-manager.js     # Main CLI router
│
├── src/                              # CLI implementation (v2.1.0)
│   ├── commands/                     # Command handlers
│   ├── lib/                          # Core business logic
│   └── utils/                        # Shared utilities
│
├── scripts/                          # Setup and logging
│   ├── postinstall.js                # Home directory setup
│   └── logging/                      # AI logging tools
│
├── ccm-artifact-packages/            # Solution packages
│   └── core-essentials.json          # Free tier package
│
├── 00_DOCS/                          # Specifications & guides
│   ├── specs/                        # Architecture specs
│   ├── strategy/                     # Distribution strategy
│   └── guides/                       # Development guides
│
└── Home Directory: ~/.claude-context-manager/
    ├── config.json                   # Configuration & license
    ├── registry.json                 # Installation tracking
    ├── cache/                        # Downloaded packages
    ├── library/                      # Artifact metadata
    └── backups/                      # Backup storage

Documentation

User Documentation

Developer Documentation

For Developers

Development Setup

Prerequisites:

Node.js v18+ and npm v9+
Git

Local Development:

# Clone repository
git clone https://github.com/vladks/claude-context-manager.git
cd claude-context-manager

# Install dependencies
npm install

# Link for local testing (creates global 'ccm' command)
npm link

# Verify local version is used
which ccm
# Should show path to your local repository

# Test CLI
ccm --version
ccm --help

Implementation Guide

Complete developer documentation:

AI Agent CLI Guide ⭐ Start Here
- Full command specifications with input/output formats
- Implementation examples for all utilities and commands
- Testing strategies and debugging approaches
- Error handling patterns
- 1,000+ lines of detailed specs

Quick context loading:

# In Claude Code, load development context
/load-code-cli

This command provides:

Implementation status matrix (what's done vs. stubbed)
Complete directory structure with status indicators
Testing workflow and debugging tips
Current development priorities
Estimated effort by phase

Project Structure

Current State (v0.1.0):

✅ Distribution infrastructure complete
✅ NPM package published
✅ Home directory auto-setup
❌ CLI commands stubbed (awaiting implementation)

Source Code Organization:

src/
├── utils/          # Core utilities (logger, config, file-ops)
├── lib/            # Business logic (registry, catalog, package-manager, license)
└── commands/       # CLI command handlers (install, list, update, etc.)

What Needs Implementation (v0.2.0):

src/utils/ - 3 files (logger, config, file-ops)
src/lib/ - 5 files (registry, catalog, package-manager, license, api-client)
src/commands/ - 8 files (list, install, update, status, activate, init, remove, search)
ccm-artifact-packages/core-essentials.json - Package definition

Testing Commands

Test individual modules:

# Test logger
node -e "const l = require('./src/utils/logger'); l.success('Test')"

# Test config
node -e "const c = require('./src/utils/config'); console.log(c.readConfig())"

Test commands end-to-end:

# After implementing list.js
ccm list

# After implementing install.js
ccm install --package core-essentials --global

# Verify installation
ls ~/.claude/skills/managing-claude-context/
cat ~/.claude-context-manager/registry.json | jq

Manual testing workflow:

Make changes to src/ files
Test locally with npm link (changes reflect immediately)
Run command: ccm <command> [options]
Verify output matches specifications
Check registry/config files updated correctly

Git Workflow

Branches:

dev - Active development (all work here)
staging - Pre-production testing (alpha releases)
master - Production (stable releases)

Workflow:

# 1. Work in dev branch
git checkout dev

# 2. Make changes and commit
git add src/utils/logger.js
git commit -m "Add: src/utils/logger.js - colored output utility"

# 3. Push to dev (CI validates only)
git push origin dev

# 4. When ready for alpha testing
git checkout staging
git merge dev
git push origin staging
# CI auto-publishes @alpha version to NPM

# 5. When ready for production
git checkout master
git merge staging
git push origin master
# CI auto-publishes production version to NPM

CI/CD Pipeline

Automated workflows:

Push to dev → Validation only (package check, lint)
Push to staging → Publish alpha to NPM (@alpha tag)
Push to master → Publish production to NPM

Testing before release:

# Dry run (no publish)
npm pack --dry-run

# Check package contents
npm pack
tar -tzf vladimir-ks-claude-context-manager-*.tgz

# Local install test
npm install -g ./vladimir-ks-claude-context-manager-*.tgz

Implementation Priorities

Phase 0: Documentation (✅ Complete)

AI Agent CLI Guide
/load-code-cli command
README developer section

Phase 1: Core Utilities (Next - 4-6 hours)

src/utils/logger.js - Colored output
src/utils/config.js - Config/registry read/write
src/utils/file-ops.js - File operations, checksums, backups

Phase 2: Library Modules (6-9 hours) 4. src/lib/registry.js - Installation tracking 5. src/lib/catalog.js - Artifact metadata 6. src/lib/package-manager.js - Install/uninstall logic 7. src/lib/license.js + api-client.js - Stubs

Phase 3: Commands (13-19 hours)

High Priority: install.js, init.js
Medium: list.js, status.js, search.js
Lower: update.js, remove.js, activate.js

Total Estimated Effort: 15-25 hours with AI assistance

Debugging

Enable debug mode:

DEBUG=true ccm install --skill pdf --global

Check environment:

# Verify Node version
node --version

# Check package installed
npm list -g @vladks/claude-context-manager

# Check home directory
ls -la ~/.claude-context-manager/
cat ~/.claude-context-manager/config.json | jq

# Trace command execution
which ccm

Common issues:

"Command not found" → Run npm link again
"Module not found" → Check file exists and path correct
"Home directory not found" → Run node scripts/postinstall.js
"Permission denied" → Check file permissions on target directory

Contributing

See CONTRIBUTING.md for:

Code style guidelines
Commit message format
Pull request process
Testing requirements

Quick contribution workflow:

Fork the repository
Create feature branch from dev
Implement changes following specs
Test locally with npm link
Submit pull request to dev branch

Development Status

v0.1.0 (Current)

Distribution Foundation:

✅ NPM package distribution
✅ Claude Code plugin distribution
✅ Home directory setup (~/.claude-context-manager/)
✅ Configuration system
✅ Documentation and specifications

CLI Implementation:

⏳ Install, update, list, status commands → v2.1.0
⏳ Premium tier integration → v2.1.0
⏳ License activation system → v2.1.0

Current Functionality:

NPM install creates home directory
ccm --help shows usage
ccm --version shows version
Free-tier artifacts bundled in package
Manual installation available

For Now: Use Claude Code plugin or manual installation until v2.1.0 CLI is released.

v2.1.0 (Coming Soon)

Full CLI command implementation
Artifact installation and management
Premium tier integration
License activation
Update with backup/restore

Support & Contributing

Get Help

Documentation: This README and docs folder
Issues: GitHub Issues
Email: [email protected]

Support This Project

⭐ Star this repository - Help others discover it
💬 Share feedback - Your insights improve the project
🐛 Report bugs - Help us improve quality
📝 Contribute - See CONTRIBUTING.md

Donations

Buy Me a Coffee: buymeacoffee.com/vladks
PayPal: paypal.me/rimidalvks
Patreon: patreon.com/vladks
Crypto: See CONTRIBUTING.md for wallet addresses

Professional Services

Consulting: Claude Code integration, context engineering ($150-300/hour)
Training: Team workshops and custom curriculum ($1,000-5,000)
Custom Development: Bespoke skills, commands, and packages
Enterprise: Complete integration with dedicated support

Contact: [email protected]

License

MIT License - see LICENSE for details.

Free tier artifacts are open source. Premium content separately licensed.