cli-profile-manager 0.0.1

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,176 @@
+# Claude Profile Manager
+
+A marketplace for saving, sharing, and loading Claude CLI configuration profiles.
+
+[![npm version](https://img.shields.io/npm/v/cli-profile-manager)](https://www.npmjs.com/package/cli-profile-manager)
+[![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
+
+## What is this?
+
+Claude Profile Manager (`cpm`) lets you:
+
+- **Save** your `.claude` folder as a shareable profile
+- **Load** profiles to switch between configurations
+- **Browse** a marketplace of community-created profiles
+- **Share** your profiles with others
+
+Dotfiles for Claude CLI, with a built-in plugin marketplace.
+
+## Installation
+
+```bash
+npm install -g cli-profile-manager
+```
+
+Requires Node.js 18+.
+
+## 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
+cpm save <name> [--description "desc"] [--tags "tag1,tag2"]
+cpm load <name> [--backup] [--force]
+cpm local
+cpm info <name>
+cpm delete <name> [--force]
+```
+
+### Marketplace
+
+```bash
+cpm list [--category <cat>] [--refresh]
+cpm search <query>
+cpm install author/profile-name [--backup] [--force]
+cpm info author/profile-name
+```
+
+### Publishing
+
+```bash
+cpm publish <name>
+cpm repo owner/repo-name
+```
+
+### Configuration
+
+```bash
+cpm config
+```
+
+## What's in a Profile?
+
+A profile snapshots your `.claude` folder:
+
+- `CLAUDE.md` - Custom instructions
+- `commands/` - Custom slash commands
+- `hooks/` - Event hooks
+- `skills/` - Custom skills
+- `mcp.json` & `mcp_servers/` - MCP server configurations
+- `plugins/` - User-authored plugins
+- `agents/` - Custom agents
+
+Sensitive files (credentials, API keys) are excluded by default.
+
+## Example Workflows
+
+### Switch Between Work Personas
+
+```bash
+cpm save work-reviewer --tags "work,code-review"
+cpm save docs-writer --tags "work,documentation"
+
+cpm load work-reviewer
+# ... do code reviews ...
+cpm load docs-writer
+# ... write documentation ...
+```
+
+### Share Team Configuration
+
+```bash
+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
+cpm list
+cpm search python
+cpm install marketplace/python-expert --backup
+
+# Restore if needed
+cpm load .claude-backup-*
+```
+
+## Profile Storage
+
+```
+~/.claude-profiles/
+├── config.json
+├── my-setup/
+│   ├── profile.json
+│   ├── CLAUDE.md
+│   ├── commands/
+│   └── hooks/
+└── .cache/
+    └── marketplace-index.json
+```
+
+## Contributing Profiles
+
+1. Save your profile: `cpm save my-awesome-profile`
+2. Publish it: `cpm publish my-awesome-profile`
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines.
+
+## Custom Marketplace
+
+Host your own marketplace (e.g., for your company):
+
+1. Fork this repository
+2. Add profiles to `profiles/`
+3. Update `index.json`
+4. Point users to your repo: `cpm repo your-org/your-marketplace`
+
+## Repository Structure
+
+```
+cli-profile-manager/
+├── src/                    # NPM package source
+│   ├── cli.js             # CLI entry point
+│   ├── commands/          # Command implementations
+│   └── utils/             # Utilities
+├── profiles/              # Marketplace profiles
+│   └── author/
+│       └── profile-name/
+│           ├── profile.json
+│           └── ...
+├── index.json             # Marketplace index
+├── package.json
+└── README.md
+```
+
+## License
+
+MIT License - see [LICENSE](./LICENSE) for details.

package/docs/devcontainer-setup.md

@@ -0,0 +1,85 @@
+# Auto-Install Claude Code + Marketplace Profiles
+
+Install Claude Code and a marketplace profile automatically. One command, all platforms.
+
+## Codespaces / Devcontainers
+
+Add a `postCreateCommand` to `.devcontainer/devcontainer.json`:
+
+```json
+{
+  "name": "Dev with Claude Code",
+  "image": "mcr.microsoft.com/devcontainers/universal:2",
+  "features": {
+    "ghcr.io/devcontainers/features/node:1": {
+      "version": "lts"
+    }
+  },
+  "postCreateCommand": "node <(curl -fsSL https://raw.githubusercontent.com/brrichards/cli-profile-manager/main/scripts/install-profile.mjs) marketplace devtools",
+  "customizations": {
+    "vscode": {
+      "extensions": ["anthropic.claude-code"]
+    }
+  }
+}
+```
+
+## Local Install
+
+Requires Node.js 18+.
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/brrichards/cli-profile-manager/main/scripts/install-profile.mjs -o install-profile.mjs && node install-profile.mjs marketplace devtools
+```
+
+Or from a cloned repo:
+
+```bash
+node scripts/install-profile.mjs marketplace devtools
+```
+
+## Available Profiles
+
+```bash
+node install-profile.mjs marketplace devtools
+node install-profile.mjs marketplace code-quality
+node install-profile.mjs marketplace git-workflow
+```
+
+Full list in [`index.json`](../index.json).
+
+## How It Works
+
+The script fetches the profile's `profile.json` manifest from GitHub and maps files into Claude Code's native structure:
+
+| Marketplace Path | Installed To |
+|---|---|
+| `CLAUDE.md` | `~/.claude/CLAUDE.md` (appended) |
+| `commands/<name>.md` | `~/.claude/skills/<name>/SKILL.md` |
+| `hooks/<name>.md` | `~/.claude/hooks/<name>.md` |
+
+### Prerequisites
+
+- **Node.js 18+** (uses built-in `fetch`, `fs`, and `path`)
+
+## Chaining With Existing Setup
+
+```json
+{
+  "postCreateCommand": "npm install && node <(curl -fsSL https://raw.githubusercontent.com/brrichards/cli-profile-manager/main/scripts/install-profile.mjs) marketplace devtools"
+}
+```
+
+## Multiple Profiles
+
+```bash
+node install-profile.mjs marketplace devtools && node install-profile.mjs marketplace code-quality
+```
+
+## Environment Variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `SKIP_CLAUDE_INSTALL` | `0` | Skip Claude Code CLI install |
+| `PROFILE_BRANCH` | `main` | Branch to fetch profiles from |
+| `CLAUDE_HOME` | `~/.claude` | Override the Claude config directory |

package/index.json

@@ -0,0 +1,51 @@
+{
+  "version": "1.0.0",
+  "lastUpdated": "2026-02-16T00:00:00Z",
+  "profiles": [
+    {
+      "name": "devtools",
+      "author": "marketplace",
+      "version": "1.0.0",
+      "description": "Developer productivity commands for dependency auditing, performance profiling, and scaffolding",
+      "tags": ["productivity", "scaffolding", "dependencies"],
+      "downloads": 0,
+      "stars": 0,
+      "createdAt": "2026-02-16T00:00:00Z",
+      "contents": {
+        "instructions": ["CLAUDE.md"],
+        "commands": ["deps", "perf", "scaffold"],
+        "hooks": ["pre-commit"]
+      }
+    },
+    {
+      "name": "code-quality",
+      "author": "marketplace",
+      "version": "1.0.0",
+      "description": "Code review, test generation, and type safety commands with quality-focused hooks",
+      "tags": ["code-review", "testing", "type-safety"],
+      "downloads": 0,
+      "stars": 0,
+      "createdAt": "2026-02-16T00:00:00Z",
+      "contents": {
+        "instructions": ["CLAUDE.md"],
+        "commands": ["review", "test-gen", "types"],
+        "hooks": ["post-save"]
+      }
+    },
+    {
+      "name": "git-workflow",
+      "author": "marketplace",
+      "version": "1.0.0",
+      "description": "Git workflow commands for PR creation, changelog generation, and commit management",
+      "tags": ["git", "workflow", "pull-requests"],
+      "downloads": 0,
+      "stars": 0,
+      "createdAt": "2026-02-16T00:00:00Z",
+      "contents": {
+        "instructions": ["CLAUDE.md"],
+        "commands": ["pr", "changelog", "squash"],
+        "hooks": ["pre-push"]
+      }
+    }
+  ]
+}

package/package.json

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

package/scripts/install-profile.mjs

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+
+// Usage:
+//   npx -y https://raw.githubusercontent.com/brrichards/cli-profile-manager/main/scripts/install-profile.mjs marketplace devtools
+//   node install-profile.mjs <author> <profile>
+//
+// Environment variables (optional):
+//   SKIP_CLAUDE_INSTALL=1   Skip installing Claude Code CLI
+//   PROFILE_BRANCH=main     Branch to fetch profiles from
+//   CLAUDE_HOME=<path>      Override the Claude config directory
+
+import { execSync } from "child_process";
+import { mkdirSync, writeFileSync, appendFileSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+
+const [author, profile] = process.argv.slice(2);
+if (!author || !profile) {
+  console.error("Usage: install-profile.mjs <author> <profile>");
+  process.exit(1);
+}
+
+const REPO = "brrichards/cli-profile-manager";
+const BRANCH = process.env.PROFILE_BRANCH || "main";
+const RAW_BASE = `https://raw.githubusercontent.com/${REPO}/${BRANCH}/profiles/${author}/${profile}`;
+const CLAUDE_DIR = process.env.CLAUDE_HOME || join(homedir(), ".claude");
+
+async function fetchText(url) {
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`Failed to fetch ${url}: ${res.status}`);
+  return res.text();
+}
+
+async function main() {
+  // Install Claude Code CLI
+  if (process.env.SKIP_CLAUDE_INSTALL !== "1") {
+    try {
+      execSync("claude --version", { stdio: "ignore" });
+      console.log("==> Claude Code CLI already installed, skipping.");
+    } catch {
+      console.log("==> Installing Claude Code CLI...");
+      execSync("npm install -g @anthropic-ai/claude-code", { stdio: "inherit" });
+    }
+  }
+
+  // Fetch profile manifest
+  console.log(`==> Fetching profile: ${author}/${profile}...`);
+  const manifest = JSON.parse(await fetchText(`${RAW_BASE}/profile.json`));
+  const contents = manifest.contents || {};
+
+  // Install instructions (CLAUDE.md)
+  for (const file of contents.instructions || []) {
+    console.log(`    Installing instruction: ${file}`);
+    const body = await fetchText(`${RAW_BASE}/${file}`);
+    mkdirSync(CLAUDE_DIR, { recursive: true });
+    appendFileSync(join(CLAUDE_DIR, "CLAUDE.md"), body + "\n");
+  }
+
+  // Install commands as skills
+  for (const cmd of contents.commands || []) {
+    console.log(`    Installing skill: ${cmd}`);
+    const skillDir = join(CLAUDE_DIR, "skills", cmd);
+    mkdirSync(skillDir, { recursive: true });
+    const body = await fetchText(`${RAW_BASE}/commands/${cmd}.md`);
+    const desc = body.split("\n")[0];
+    writeFileSync(
+      join(skillDir, "SKILL.md"),
+      `---\nname: ${cmd}\ndescription: ${desc}\n---\n\n${body}\n`
+    );
+  }
+
+  // Install hooks
+  for (const hook of contents.hooks || []) {
+    console.log(`    Installing hook: ${hook}`);
+    const hooksDir = join(CLAUDE_DIR, "hooks");
+    mkdirSync(hooksDir, { recursive: true });
+    const body = await fetchText(`${RAW_BASE}/hooks/${hook}.md`);
+    writeFileSync(join(hooksDir, `${hook}.md`), body);
+  }
+
+  console.log(`\n==> Done! Profile '${author}/${profile}' installed to ${CLAUDE_DIR}`);
+}
+
+main().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/src/cli.js

@@ -0,0 +1,165 @@
+#!/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')
+  .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();