claude-profile-manager 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Claude Profile Marketplace Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,233 @@
+# 🚀 Claude Profile Manager
+
+A marketplace for saving, sharing, and loading Claude CLI configuration profiles.
+
+[![npm version](https://img.shields.io/npm/v/claude-profile-manager)](https://www.npmjs.com/package/claude-profile-manager)
+[![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
+
+## What is this?
+
+Claude Profile Manager (`cpm`) lets you:
+
+- **📸 Save** your entire `.claude` folder as a shareable profile
+- **🔄 Load** profiles to instantly switch between configurations  
+- **🛒 Browse** a marketplace of community-created profiles
+- **📤 Share** your profiles with others
+
+Think of it like dotfiles for Claude CLI, with a built-in plugin marketplace.
+
+## Installation
+
+```bash
+npm install -g claude-profile-manager
+```
+
+Requires Node.js 18+ (already installed if you're using Claude CLI).
+
+## Quick Start
+
+```bash
+# Save your current Claude config as a profile
+cpm save my-setup
+
+# List profiles in the marketplace
+cpm list
+
+# Install a profile from the marketplace
+cpm install marketplace/senior-developer
+
+# Load your saved profile
+cpm load my-setup
+```
+
+## Commands
+
+### Local Profile Management
+
+```bash
+# Save current .claude folder as a profile
+cpm save <n> [--description "desc"] [--tags "tag1,tag2"]
+
+# Load a saved profile (replaces current .claude)
+cpm load <n> [--backup] [--force]
+
+# List your locally saved profiles
+cpm local
+
+# View profile details
+cpm info <n>
+
+# Delete a local profile
+cpm delete <n> [--force]
+```
+
+### Marketplace
+
+```bash
+# Browse all marketplace profiles
+cpm list [--category <cat>] [--refresh]
+
+# Search the marketplace
+cpm search <query>
+
+# Install a profile from marketplace
+cpm install author/profile-name [--backup] [--force]
+
+# View marketplace profile details
+cpm info author/profile-name
+```
+
+### Publishing
+
+```bash
+# Publish your profile to the marketplace
+cpm publish <n>
+
+# Use a custom marketplace repository
+cpm repo owner/repo-name
+```
+
+### Configuration
+
+```bash
+# Show current configuration
+cpm config
+```
+
+## What's in a Profile?
+
+A profile is a complete snapshot of your `.claude` folder, including:
+
+- `settings.json` - Your Claude CLI settings
+- `CLAUDE.md` - Custom instructions
+- `commands/` - Custom slash commands
+- `mcp.json` & `mcp_servers/` - MCP server configurations
+- `projects/` - Project-specific settings
+- And more...
+
+**Security Note:** By default, sensitive files (credentials, API keys, etc.) are excluded from snapshots. Use `--include-secrets` only if you're sure.
+
+## Example Workflows
+
+### Switch Between Work Personas
+
+```bash
+# Save your code review setup
+cpm save work-reviewer --tags "work,code-review"
+
+# Save your documentation setup  
+cpm save docs-writer --tags "work,documentation"
+
+# Switch between them
+cpm load work-reviewer
+# ... do code reviews ...
+cpm load docs-writer
+# ... write documentation ...
+```
+
+### Share Team Configuration
+
+```bash
+# Lead saves team config
+cpm save team-standards --description "Our team's Claude configuration"
+cpm publish team-standards
+
+# Team members install it
+cpm install yourname/team-standards
+```
+
+### Try Community Profiles
+
+```bash
+# Browse what's available
+cpm list
+
+# Search for Python-focused profiles
+cpm search python
+
+# Try one out (with backup)
+cpm install marketplace/python-expert --backup
+
+# Don't like it? Restore your backup
+cpm load .claude-backup-*
+```
+
+## Profile Storage
+
+Profiles are stored in `~/.claude-profiles/`:
+
+```
+~/.claude-profiles/
+├── config.json           # CPM settings
+├── my-setup/
+│   ├── profile.json      # Profile metadata
+│   └── snapshot.zip      # Compressed .claude folder
+├── work-reviewer/
+│   ├── profile.json
+│   └── snapshot.zip
+└── .cache/
+    └── marketplace-index.json
+```
+
+## Contributing Profiles
+
+Want to share your profile with the community?
+
+1. Save your profile: `cpm save my-awesome-profile`
+2. Publish it: `cpm publish my-awesome-profile`
+3. Follow the instructions to submit a PR
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines.
+
+## Creating a Custom Marketplace
+
+You can host your own marketplace (e.g., for your company):
+
+1. Fork this repository
+2. Add profiles to the `profiles/` directory
+3. Update `index.json`
+4. Have users point to your repo:
+
+```bash
+cpm repo your-org/your-marketplace
+```
+
+## Repository Structure
+
+```
+claude-profile-marketplace/
+├── src/                    # NPM package source
+│   ├── cli.js             # CLI entry point
+│   ├── commands/          # Command implementations
+│   └── utils/             # Utilities
+├── profiles/              # Marketplace profiles
+│   └── author/
+│       └── profile-name/
+│           ├── profile.json
+│           └── snapshot.zip
+├── index.json             # Marketplace index
+├── package.json
+└── README.md
+```
+
+## FAQ
+
+**Q: Is it safe to share profiles?**
+
+A: By default, sensitive files are excluded. However, always review your profile before publishing. Don't share profiles that contain API keys or credentials.
+
+**Q: Can I use this with GitHub Copilot CLI too?**
+
+A: Currently focused on Claude CLI, but the architecture supports extending to other tools.
+
+**Q: What if I mess up my config?**
+
+A: Use `--backup` when loading profiles to save your current config first. You can restore it with `cpm load .claude-backup-*`.
+
+## License
+
+MIT License - see [LICENSE](./LICENSE) for details.
+
+---
+
+**Made with ❤️ for the Claude CLI community**

package/index.json

@@ -0,0 +1,56 @@
+{
+  "version": "1.0.0",
+  "lastUpdated": "2025-02-15T00:00:00Z",
+  "profiles": [
+    {
+      "name": "senior-developer",
+      "author": "marketplace",
+      "version": "1.0.0",
+      "description": "Senior software engineer persona with focus on code review, architecture, and mentoring",
+      "tags": ["code-review", "architecture", "mentoring"],
+      "downloads": 0,
+      "stars": 0,
+      "createdAt": "2025-02-15T00:00:00Z"
+    },
+    {
+      "name": "security-auditor",
+      "author": "marketplace",
+      "version": "1.0.0",
+      "description": "Security-focused reviewer checking for OWASP vulnerabilities and best practices",
+      "tags": ["security", "owasp", "code-review"],
+      "downloads": 0,
+      "stars": 0,
+      "createdAt": "2025-02-15T00:00:00Z"
+    },
+    {
+      "name": "python-expert",
+      "author": "marketplace",
+      "version": "1.0.0",
+      "description": "Python development expert with focus on idiomatic code, typing, and async patterns",
+      "tags": ["python", "typing", "async"],
+      "downloads": 0,
+      "stars": 0,
+      "createdAt": "2025-02-15T00:00:00Z"
+    },
+    {
+      "name": "test-writer",
+      "author": "marketplace",
+      "version": "1.0.0",
+      "description": "Specialized in generating comprehensive test suites with high coverage",
+      "tags": ["testing", "tdd", "quality"],
+      "downloads": 0,
+      "stars": 0,
+      "createdAt": "2025-02-15T00:00:00Z"
+    },
+    {
+      "name": "docs-generator",
+      "author": "marketplace",
+      "version": "1.0.0",
+      "description": "Technical documentation writer for APIs, READMEs, and code comments",
+      "tags": ["documentation", "api-docs", "readme"],
+      "downloads": 0,
+      "stars": 0,
+      "createdAt": "2025-02-15T00:00:00Z"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "claude-profile-manager",
+  "version": "1.0.0",
+  "description": "Save, share, and load Claude CLI profiles - a marketplace for Claude configurations",
+  "main": "src/index.js",
+  "bin": {
+    "cpm": "src/cli.js",
+    "claude-profiles": "src/cli.js"
+  },
+  "scripts": {
+    "test": "node src/cli.js --help"
+  },
+  "keywords": [
+    "claude",
+    "anthropic",
+    "cli",
+    "profiles",
+    "configuration",
+    "dotfiles",
+    "copilot"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/YOUR_USERNAME/claude-profile-marketplace.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "archiver": "^6.0.1",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "extract-zip": "^2.0.1",
+    "inquirer": "^9.2.12",
+    "node-fetch": "^3.3.2",
+    "ora": "^8.0.1"
+  }
+}

package/src/cli.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { 
+  saveProfile, 
+  loadProfile, 
+  listLocalProfiles,
+  deleteLocalProfile,
+  showProfileInfo
+} from './commands/local.js';
+import { 
+  listMarketplace, 
+  searchMarketplace, 
+  installFromMarketplace,
+  showMarketplaceInfo
+} from './commands/marketplace.js';
+import { 
+  publishProfile,
+  setRepository 
+} from './commands/publish.js';
+import { getConfig } from './utils/config.js';
+
+const VERSION = '1.0.0';
+
+const program = new Command();
+
+// Banner
+const banner = `
+${chalk.cyan('   ____ ____  __  __')}
+${chalk.cyan('  / ___|  _ \\|  \\/  |')}
+${chalk.cyan(' | |   | |_) | |\\/| |')}
+${chalk.cyan(' | |___|  __/| |  | |')}
+${chalk.cyan('  \\____|_|   |_|  |_|')}
+  
+  ${chalk.magenta('Claude Profile Manager v' + VERSION)}
+`;
+
+program
+  .name('cpm')
+  .description('Save, share, and load Claude CLI profiles')
+  .version(VERSION)
+  .addHelpText('before', banner);
+
+// ============================================================================
+// Local Profile Commands
+// ============================================================================
+
+program
+  .command('save <name>')
+  .description('Save current .claude folder as a profile snapshot')
+  .option('-d, --description <desc>', 'Profile description')
+  .option('-t, --tags <tags>', 'Comma-separated tags')
+  .option('--include-secrets', 'Include sensitive files (use with caution)')
+  .action(async (name, options) => {
+    await saveProfile(name, options);
+  });
+
+program
+  .command('load <name>')
+  .description('Load a profile (local or from marketplace)')
+  .option('-f, --force', 'Overwrite existing .claude folder without prompting')
+  .option('--backup', 'Backup current .claude folder before loading')
+  .option('--marketplace', 'Load from marketplace instead of local')
+  .action(async (name, options) => {
+    if (options.marketplace || name.includes('/')) {
+      await installFromMarketplace(name, options);
+    } else {
+      await loadProfile(name, options);
+    }
+  });
+
+program
+  .command('local')
+  .description('List locally saved profiles')
+  .action(async () => {
+    await listLocalProfiles();
+  });
+
+program
+  .command('delete <name>')
+  .description('Delete a locally saved profile')
+  .option('-f, --force', 'Delete without confirmation')
+  .action(async (name, options) => {
+    await deleteLocalProfile(name, options);
+  });
+
+program
+  .command('info <name>')
+  .description('Show detailed info about a profile')
+  .option('--marketplace', 'Show marketplace profile info')
+  .action(async (name, options) => {
+    if (options.marketplace || name.includes('/')) {
+      await showMarketplaceInfo(name);
+    } else {
+      await showProfileInfo(name);
+    }
+  });
+
+// ============================================================================
+// Marketplace Commands
+// ============================================================================
+
+program
+  .command('list')
+  .alias('browse')
+  .description('Browse profiles in the marketplace')
+  .option('-c, --category <category>', 'Filter by category')
+  .option('--refresh', 'Force refresh the marketplace index')
+  .action(async (options) => {
+    await listMarketplace(options);
+  });
+
+program
+  .command('search <query>')
+  .description('Search the marketplace')
+  .action(async (query) => {
+    await searchMarketplace(query);
+  });
+
+program
+  .command('install <profile>')
+  .description('Install a profile from the marketplace (format: author/name)')
+  .option('-f, --force', 'Overwrite existing .claude folder')
+  .option('--backup', 'Backup current config before installing')
+  .action(async (profile, options) => {
+    await installFromMarketplace(profile, options);
+  });
+
+// ============================================================================
+// Publishing Commands
+// ============================================================================
+
+program
+  .command('publish <name>')
+  .description('Publish a local profile to the marketplace')
+  .option('--public', 'Make the profile publicly visible')
+  .action(async (name, options) => {
+    await publishProfile(name, options);
+  });
+
+program
+  .command('repo <repository>')
+  .description('Set custom marketplace repository (format: owner/repo)')
+  .action(async (repository) => {
+    await setRepository(repository);
+  });
+
+// ============================================================================
+// Utility Commands  
+// ============================================================================
+
+program
+  .command('config')
+  .description('Show current configuration')
+  .action(async () => {
+    const config = await getConfig();
+    console.log(banner);
+    console.log(chalk.bold('Configuration:\n'));
+    console.log(`  ${chalk.cyan('Profiles Directory:')} ${config.profilesDir}`);
+    console.log(`  ${chalk.cyan('Claude Directory:')}   ${config.claudeDir}`);
+    console.log(`  ${chalk.cyan('Marketplace Repo:')}   ${config.marketplaceRepo}`);
+    console.log(`  ${chalk.cyan('Cache Directory:')}    ${config.cacheDir}`);
+  });
+
+program.parse();